{"article":{"id":360011999877,"url":"https://appsflyer.zendesk.com/api/v2/help_center/en-us/articles/360011999877.json","html_url":"https://support.appsflyer.com/hc/en-us/articles/360011999877-App-list-API-for-app-owners","author_id":6998065863185,"comments_disabled":true,"draft":false,"promoted":false,"position":4,"vote_sum":0,"vote_count":0,"upvote_count":0,"downvote_count":0,"section_id":6551015977105,"created_at":"2020-08-17T18:07:10Z","updated_at":"2026-10-13T00:44:56Z","name":"App list API for app owners","title":"App list API for app owners","source_locale":"en-us","locale":"en-us","outdated":false,"outdated_locales":[],"edited_at":"2026-05-05T06:57:58Z","user_segment_id":null,"permission_group_id":11065,"content_tag_ids":["01M0A1D9J4G66M4K4HKQ8Q4H95","01M1BKPRCNM7DC2H1G30BHYY5M","01M1BKPZ6YS0VWJMBV21G9XNY7"],"label_names":["Advertisers","Marketers","Loc Published"],"body":"

At a glance: Retrieve active and pending apps associated with your AppsFlyer account.

\"mceclip0.png\"

If you are an ad network, use the app list for ad networks API.

Further reading: API list for advertisers

Get app list API

The following sections include information necessary for using the API. 

Get app list basics

\n
\n

Get API list basics

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
CategoryItemDescription
RequestHTTP methodGET
Pathhttps://hq1.appsflyer.com/api/mng/apps
Authorization header 
 ResponseResultsReturn in a JSON
Request limit
    \n
  • 20 requests/minute
    • \n
  • 100 requests/day
    • \n
Record limit1,000 records/request. If more than 1,000 records are to return, use follow-on pagination requests described in this article.
\n
\n
\n

API request

\n
\n

The API request consists of the method, path, mandatory capabilities parameter, and optional pagination parameters. The token is contained in the authorization header. 

\n

Method

\n
GET https://hq1.appsflyer.com/api/mng/apps
\n

Get app list mandatory parameters:

\n
\n\n\n\n\n\n\n\n\n
Query parameterDescription
  There are no mandatory query parameters for this API

\n
Pagination mechanism\n

\n

A pagination mechanism, always operational, is implemented. 

\n

Pagination principles: 

\n
    \n
  • Returns up to 1,000 records per request (page).
    • \n
  • Response JSONs contain the following pagination-related keys:
      \n
    • \nmeta.total_items: The number of records to be returned by all pages combined. This represents the number of apps for which you have been granted the capabilities being queried.
      • \n
    • Pagination links (depicted in the JSON that follows) have the following keys:
        \n
      • \nlinks.prev: If there was a previous request: the request used to generate the previous page.
        • \n
      • \nlinks.self: The current request: the request used to generate the current JSON (page)
        • \n
      • \nlinks.next: The request required to get the next page. If there is no next key, this is the last page. 
        • \n
      \n
      • \n
    \n
    • \n
\n

 Use one of the following pagination control methods:

\n
    \n
  • [Best practice] Use the links in the JSON: If the links.next key exists, use it to create a request to get the next page. Continue to do so until you receive a JSON without a links.next key.\n
    • \n
  • Programmatically implement limit and offset parameters in conjunction with the total_items key.
    • \n
\n

Pagination links JSON example

\n
    \n
  • The example that follows contains the result of the second request, consisting of two records in the data section (not displayed). 
    • \n
  • The total number of records to return is 6.
    • \n
  • The links.next key contains the request that returns the second page—records 5 and 6. 
    • \n
\n
{                                                                                         \n    \"data\": {[...]},   \n    \"meta\": {\n        \"total_items\": 6\n    },\n    \"links\": {\n        \"prev\": \"https://hq1.appsflyer.com/api/mng/apps?offset=0&limit=2\",\n        \"self\": \"https://hq1.appsflyer.com/api/mng/apps?offset=2&limit=2\",\n        \"next\": \"https://hq1.appsflyer.com/api/mng/apps?offset=4&limit=2\"\n    }\n}
\n

Pagination mechanism parameters (optional):

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Query parameterDescription
limit\n

Number of records that return per call

\n
    \n
  • Maximum: 1,000
    • \n
  • If you don't sendlimit, it is automatically set to 1,000.
    • \n
  • Example: limit=2\n
    • \n
  • Mandatory: No
    • \n
\n
offset\n

The first record to return in the call. Record numbers start with 0. 

\n
    \n
  • If you don't send offset, it is automatically set to 0.
    • \n
  • Example: offset=2\n
    • \n
  • Mandatory: No
    • \n
\n
\n
\n
\n
\n

JSON response

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
KeyDescription
idApp ID, for example: id123456789, com.myapp.com\n
typeAlways return app 
nameApp name
platformiOS or Android
currencyApp-specific currency code 
time_zoneApp-specific timezone
total_itemsNumber of apps housed in the account
links\n

Pagination mechanism (explained in the parameters section)

\n
    \n
  • prev: the call used to generate the previous page
    • \n
  • self: the call used to generate the current page
    • \n
  • next: the call used to generate the next page
    • \n
\n
\n
\n
\n

Get app list cURL example and response

\n
\n

CURL request

\n

This example includes a complete call, including optional pagination parameters. 

\n
cURL --location --request GET 'https://hq1.appsflyer.com/api/mng/apps?limit=1000&offset=0' \\\n-H 'Authorization: Bearer {API V2.0 token having more than 700 characters available to the admin in the dashboard.}' \\
\n

JSON response

\n
{\n    \"data\": [\n        {\n            \"id\": \"com.appsflyer.xpend_qa1\",\n            \"type\": \"app\",\n            \"attributes\": {\n                \"name\": \"com.appsflyer.xpend_qa1\",\n                \"platform\": \"android\",\n                \"currency\": \"USD\",\n                \"time_zone\": \"UTC\"\n            }\n        },\n        {\n            \"id\": \"com.abc.app\",\n            \"type\": \"app\",\n            \"attributes\": {\n                \"name\": \"com.abc.app\",\n                \"platform\": \"android\",\n                \"currency\": \"USD\",\n                \"time_zone\": \"UTC\",\n                \"enable_retargetting\": true\n            }\n        },\n        {\n            \"id\": \"com.def.app\",\n            \"type\": \"app\",\n            \"attributes\": {\n                \"name\": \"com.def.app\",\n                \"platform\": \"android\",\n                \"currency\": \"JPY\",\n                \"time_zone\": \"UTC\"\n            }\n        }\n    ],\n    \"meta\": {\n        \"total_items\": 6\n    },\n    \"links\": {\n        \"self\": \"https://hq1.appsflyer.com/api/mng/apps?offset=0&limit=1000\"\n           }\n}
\n
\n
\n
\n

HTTP response codes

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Code MessageRemarks/troubleshooting
200OKValid data returned
200OK\n

Symptom: No data returns

\n

Action: Make sure the authentication token is in the bearer header.

\n
400Bad requestSee the message contained in the JSON
401Unauthorized\n

Message: Authorization token is malformed

\n

Make sure you have the correct token; token must have 700+ characters.

\n
404Not found
    \n
  • Handle any network or firewall-related problems. 
    • \n
  • Make sure that AppsFlyer IP addresses are allowlisted\n
    • \n
  • Make sure you use the most recently-issued token.
    • \n
  • No data found: No apps found. 
    • \n
429Too many requestsExceeded rate limitation
\n
\n
","user_segment_ids":[]}}