GET
/
apps
curl --request GET \
  --url https://api.onesignal.com/apps \
  --header 'Authorization: <authorization>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "players": 123,
    "messageable_players": 123,
    "created_at": "<string>",
    "updated_at": "<string>",
    "organization_id": "<string>"
  }
]

Overview

Use this API to retrieve metadata for all OneSignal apps associated with your account. This includes app names, App IDs, subscription counts, and timestamps, making it easy to programmatically manage or audit your applications.

This API does not return the app’s API keys. To manage API keys, use the Create API Key, Rotate API Key, and Delete API Key APIs.

This API is limited to return a maximum of 1000 Apps. If you need access to more, then you should store the app_id and name for each of your apps on your own server to look up with the View an app API to get data for each app separately. Also, if you need to delete apps, then you can provide the app_id and name to OneSignal Support and ask for these to be deleted.


How to use this API

To retrieve your apps, send a GET request to the /apps endpoint using your Organization API Key. This key can be found in your OneSignal dashboard under Organization > Keys & IDs.


Headers

Authorization
string
default:Key YOUR_ORGANIZATION_API_KEY
required

Your Organization API key with prefix Key. See Keys & IDs.

Response

200 - application/json

200

The response is of type object[].

GET
/
apps
curl --request GET \
  --url https://api.onesignal.com/apps \
  --header 'Authorization: <authorization>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "players": 123,
    "messageable_players": 123,
    "created_at": "<string>",
    "updated_at": "<string>",
    "organization_id": "<string>"
  }
]

Overview

Use this API to retrieve metadata for all OneSignal apps associated with your account. This includes app names, App IDs, subscription counts, and timestamps, making it easy to programmatically manage or audit your applications.

This API does not return the app’s API keys. To manage API keys, use the Create API Key, Rotate API Key, and Delete API Key APIs.

This API is limited to return a maximum of 1000 Apps. If you need access to more, then you should store the app_id and name for each of your apps on your own server to look up with the View an app API to get data for each app separately. Also, if you need to delete apps, then you can provide the app_id and name to OneSignal Support and ask for these to be deleted.


How to use this API

To retrieve your apps, send a GET request to the /apps endpoint using your Organization API Key. This key can be found in your OneSignal dashboard under Organization > Keys & IDs.


Headers

Authorization
string
default:Key YOUR_ORGANIZATION_API_KEY
required

Your Organization API key with prefix Key. See Keys & IDs.

Response

200 - application/json

200

The response is of type object[].