fastlane / itc-api-docs

The unofficial documentation of the iTunes Connect JSON API

fastlane is a tool for iOS and Android developers to automate tedious tasks like generating screenshots, dealing with provisioning profiles, and releasing your application.

---

✨ All fastlane docs were moved to docs.fastlane.tools ✨

---

Need Help?

Before submitting a new GitHub issue, please make sure to

• Check out docs.fastlane.tools
• Search for existing GitHub issues

If the above doesn't help, please submit an issue on GitHub and provide information about your setup, in particular the output of the fastlane env command.

Note: If you want to report a regression in fastlane (something that has worked before, but broke with a new release), please mark your issue title as such using [Regression] Your title here. This enables us to quickly detect and fix regressions.

fastlane team

Manu Wallner	Joshua Liebowitz	Danielle Tomlinson	Satoshi Namai	Felix Krause
Łukasz Grabowski	Maksym Grebenets	Fumiya Nakamura	Jérôme Lacoste	Stefan Natchev
Helmut Januschka	Manish Rathi	Max Ott	Jimmy Dee	Roger Oba
Iulian Onofrei	Josh Holtz	Daniel Jankowski	Andrew McBurney	Jan Piotrowski
Luka Mirosevic	Kohki Miki	Aaron Brager	Olivier Halligon	Jorge Revuelta H
Matthew Ellis

Special thanks to all contributors for extending and improving fastlane.

Contribute to fastlane

Check out CONTRIBUTING.md for more information on how to help with fastlane.

Code of Conduct

Help us keep fastlane open and inclusive. Please read and follow our Code of Conduct.

Metrics

fastlane tracks a few key metrics to understand how developers are using the tool and to help us know what areas need improvement. No personal/sensitive information is ever collected. Metrics that are collected include:

• The number of fastlane runs
• A salted hash of the app identifier or package name, which helps us anonymously identify unique usage of fastlane

You can easily opt-out of metrics collection by adding opt_out_usage at the top of your Fastfile or by setting the environment variable FASTLANE_OPT_OUT_USAGE. Check out the metrics code on GitHub

License

This project is licensed under the terms of the MIT license. See the LICENSE file.

This project and all fastlane tools are in no way affiliated with Apple Inc. This project is open source under the MIT license, which means you have full access to the source code and can modify it to fit your own needs. All fastlane tools run on your own computer or server, so your credentials or other sensitive information will never leave your own computer. You are responsible for how you use fastlane tools.

---

✨ All fastlane docs were moved to docs.fastlane.tools ✨

---

itc-api-docs's Issues

itc api

Hey @KrauseFx, I'm working on a personal project and looking for some type of documentation on how to authenticate with ITC. That's really all I need, just need some way to ensure my iOS app is authenticated on ITC so I can run other queries I have setup already to go.

Can you point me in the right direction?

HTTP Error 403: Forbidden

today , https://itunesconnect.apple.com New features and updates for iTunes Connect. Can you fix it.

Recent Update of login API

So, Apple updates their APIs

Now the Login URL is
https://idmsa.apple.com/appleauth/auth/signin
with appliation/json POST request with the following parameters:
{"accountName":"[email protected]","password":"password","rememberMe":true}

it will respond with "X-SESS", "site" and "aa" cookie. After this point I am stuck, as the website somehow gets "wosid" cookie, couldn't track it so far.

Any suggestions?

Paw example file is out-of-date (or corrupt?)

I tried using the example Paw file per the docs but get an error from Paw 3.0.16:

"Crossfire-response-badrequest-title": "The URL is invalid."

I started receiving the error

{
  "itcBaseUrl": "https://itunesconnect.apple.com",
  "message": "Make sure the URL is correct and try again.",
  "l10n": {
    "Crossfire-response-badrequest-title": "The URL is invalid.",
    "Crossfire-response-badrequest-message": "Make sure the URL is correct and try again."
  },
  "errors": []
}

recently. Turns out that when making requests to analytics.itunes.apple.com there now needs to be the HTTP header:

'X-Requested-By' => 'analytics.itunes.apple.com'

Can't login

Played with the options in Paw for an hour. I tried deleting the cookies as suggested, but it still returns 200 without logging in. Not sure what's going on. Response i'm getting:

App Rejection API's?

I haven't seen anything regarding app rejection here. If I want to check the reasons my app was rejected and handle these issues, without going into iTunes connect directly; I don't see a way currently.

when official documentation of the iTunes Connect JSON API will release ??

when official documentation of the iTunes Connect JSON API will release ??
apple said iTC API will release in summer ???

the pre-filled PAW file could not be opened.

I downloaded this file, but Paw can't open it. Who can help me.

Cancel "Waiting for Review"

Hi @KrauseFx ,

I know that is not your problem, but can you help me to remove an app from review? (http://stackoverflow.com/questions/32959058/ios-9-cant-remove-build-from-review-in-itunesconnect) This option is disabled on the new iTC panel and I can't find a way to get it working with Apple Support.

I've tried using https://itunesconnect.apple.com/WebObjects/iTunesConnect.woa/ra/apps/version/reject/[app_id] but it is marked as deprecated. Do you new what would be the new path?

Thank you very much!

how to use the api and get our app scores?

I had used fastlane gym and pilot sapceship several times,but I only used the command like

DEVELOPER_DIR="/Applications/Xcode8.app" pilot upload --verbose 
--username ${username} --app_identifier ${bundle_id} 
--changelog ${changelog} --ipa ${ipa_path} --distribute_external 
${distribute_external} --apple_id ${apple_id} --team_id ${team_id} 
--team_name "${team_name}" 
--dev_portal_team_id ${dev_portal_team_id} 
--itc_provider "${itc_provider}"

Now I want to get our app scores and something others like this picture

@KrauseFx How can I used the api to get these things? Can you help me? Thanks very much and the fastlane tools are great good.

Can't open paw file

I have installed paw Version 3.1.5 and it refuses to open this file. The error is "The document “iTunesConnectAPI.paw” could not be opened. The file isn’t in the correct format.". Any suggestions?

How can I get iap or price information by using this api？

Now I can get the detail information like screenshot, describe about my app with this api.

But how can I get the price or iap information?

Getting 401 Unauthorised for all except Login

From the Login api I get 302.
All other api's are either giving 401, or 404 (only one - manageapps/summary).

Is it me doing something wrong, or it is an issue and the api does not work for iTunes ?

iTunes has changed the login and stats apis

Starting today this stopped working

IAP Management

Is there any information about managing the IAP products through the unofficial API ?

Paw file is corrupted

@KrauseFx I'm trying to open the Paw file with the predefined values to reach the iTunes Connect API but I think the way in which was created the file is different now in Paw as they are encrypting the Paw files I think because I can open your file and see the XML but not for the new ones.

Can you mind please submit a new one updated if you have it?? Thanks

[Request] postman collection

A postman collection would be a good idea

App json urls now deprecated

It seems that the list apps url and maybe others are now returning json stating that the it is deprecated. Just started happening for me.

Save uploaded build train

Once upload IPA to iTunesConnect, in the UI, you need to click the "+" button, select the build you just uploaded and hit save. I didn't find it in the API, am I missing anything?