Amazon Developer

as

Settings
Sign out
Notifications
Alexa
Amazon Appstore
Ring
AWS
Documentation
Support
Contact Us
My Cases
Get Started
Design and Develop
Publish
Reference
Support
Native
Skip to main content
The App Submission API for Testing is a REST API that lets you programmatically register your app for Appstore DevTest and add testers. Before using the API, you must set up access and obtain an OAuth session token, which you’ll include in the HTTP header of each API request.

Base URL

The base URL of the App Submission API for Testing is developer.amazon.com/api/appstore.

Authentication

Operations

The App Submission API for Testing includes the following operations.
OperationHTTP method and URI
Register your appPOST /{apiVersion}/applications/{appId}/devtest/register
Add testersPOST /{apiVersion}/applications/{appId}/tracks/{trackId}/testers

Register your app

Registers your app for Appstore DevTest for In-App Purchasing (IAP).

Request

To register your app for Appstore DevTest for IAP, you make a POST request to the /{apiVersion}/applications/{appId}/devtest/register endpoint. In the request body, provide your app’s package name and the certificate you will use to sign the app.

Request example

Request parameters

ParameterLocated inDescriptionTypeRequired
apiVersionPathVersion of the API, currently v1.StringYes
appIdPathIdentifier for the app. Example: amzn1.devportal.mobileapp.dde7ec787b031584aa5f04606184041a.StringYes
access tokenHeaderStringYes

Request body example

Request body properties

ParameterDescriptionTypeRequired
packageNameThe package name of your app.StringYes
certificateThe certificate you will use to sign your app.StringYes

Response

A successful response returns HTTP 200 OK, along with the trackId, which you’ll use in the add testers request. On error, the response returns the appropriate HTTP status code and includes a response body with an error code and human-readable message.

Response body example

Response body properties

ParameterDescriptionType
trackIdIdentifies the track for an app. For DevTest, the value is devtest.String

HTTP status codes

StatusDescription
200 OKApp successfully registered for DevTest.
404 Not FoundRequested resource not found.
400 Bad RequestIndicates that one or more properties in the request body aren’t valid or are absent.

Add testers to DevTest for IAP

Adds testers to the DevTest environment for IAP testing.

Request

To add testers to DevTest for IAP, you make a POST request to the /{apiVersion}/applications/{appId}/tracks/{trackId}/testers endpoint. In the request, you must use the trackId returned in the registration response. You must also specify the tester group names that you want to add your testers to, and provide the tester details.

Request example

Request parameters

ParameterLocated inDescriptionTypeRequired
apiVersionPathVersion of the API, currently v1.StringYes
appIdPathIdentifier for the app. Example: amzn1.devportal.mobileapp.dde7ec787b031584aa5f04606184041a.StringYes
access tokenHeaderStringYes

Request body example

Request body properties

ParameterDescriptionTypeRequired
groupsList of tester groups.List<TesterGroup>Yes
nameName of the tester group.StringYes
testersList of testers.List<Tester>Yes
firstNameTester’s first name.StringNo
lastNameTester’s last name.StringNo
emailTester’s email address.StringYes

Response

A successful response returns HTTP 200 OK and includes a list of the tester groups added and the number of unique testers across the groups. On error, the response returns the appropriate HTTP status code and includes a response body with an error code and human-readable message.

Response body example

Response body properties

ParameterDescriptionType
groupsList of tester group names added to the DevTest registration for this app.List<String>
uniqueTesterCountThe number of unique testers added across tester groups.Integer

HTTP status codes

StatusDescription
200 OKTesters successfully added to DevTest for the app.
404 Not FoundRequested resource not found.
400 Bad RequestIndicates that one or more properties in the request body aren’t valid or are absent.

Object definitions

The App Submission API for Testing uses the following objects.

TesterGroup object

The TesterGroup object contains the name of the tester group and a list of testers.
ParameterDescriptionType
nameName of the tester group.String
testersList of testers.List<Tester>

Tester object

The Tester object contains the tester details.
ParameterDescriptionType
firstNameTester’s first name.String
lastNameTester’s last name.String
emailTester’s email address.String

Last modified on September 30, 2025