Application API
Use the Application API to programmatically manage your apps on the ironSource platform, including creation, updates, and settings adjustments.
Use this API to get and create applications on ironSource's dashboard.
Get apps
Description
Use this API to retrieve a list of all of your apps. The response will include the detailed parameters as described in the table above
Authentication type
Bearer API authentication
Method
GET:
platform.ironsrc.com/partners/publisher/applications/v6?
Required parameters: None
Request example URL: https://platform.ironsrc.com/partners/publisher/applications/v6?
Optional parameters
To reduce the amount of applications returning in response, filter results by adding the following parameters:
Filter parameter | Description | Value |
|---|
| Operation system | iOS / Android |
| Application activation status | Active / archived |
Request example URL
https://platform.ironsrc.com/partners/publisher/applications/v6?appStatus=active
Response parameters
Name | Description |
|---|
| application Key (as seen on our platform) |
| the application name |
| app status can be active or inactive |
| iOS or Android |
| the store bundle id |
| the application store track id (iOS only) |
| the application sub-genre. |
| the date the application was added to ironSource platform |
| the application icon (fetch from the store) |
| includes the active ad networks names per ad unit |
| includes the active ad network's reporting API status |
| The COPPA settings of the application (true=1/false=0) |
| the CCPA settings of the application (true=1/false=0) |
JSON example response
[ { "appKey": "6be7c3bd", "appName": "puzzl2999", "appStatus": "active", "platform": "Android", "bundleId": "unknown", "taxonomy": "Bingo", "creationDate": "01/01/2020", "icon": "https://local.supersonicads.com/ssastatic/partners/assets/images/appDefaultIcon.v3.png", "adUnits": { "rewardedVideo": { "activeNetworks": [ "ironSource" ] }, "offerWall": { "activeNetworks": [ "ironSource" ] }, "interstitial": { "activeNetworks": [ "ironSource" ] }, "banner": { "activeNetworks": [ "ironSource" ] } }, "networkReportingApi": { "ironSource": "verified" }, "bundleRefId": 0, "coppa": 1, "ccpa": 1 }, { "appKey": "6be7e081", "appName": "puzzl2999666", "appStatus": "active", "platform": "Android", "bundleId": "unknown", "taxonomy": "Bingo", "creationDate": "01/01/2020", "icon": "https://local.supersonicads.com/ssastatic/partners/assets/images/appDefaultIcon.v3.png", "adUnits": { "rewardedVideo": { "activeNetworks": [ "ironSource" ] }, "offerWall": { "activeNetworks": [ "ironSource" ] }, "interstitial": { "activeNetworks": [ "ironSource" ] }, "banner": { "activeNetworks": [ "ironSource" ] } }, "networkReportingApi": { "ironSource": "verified" }, "bundleRefId": 0, "coppa": 1, "ccpa": 0 }]
Create app
Description
Use this API to create an app on ironSource platform. When creating an app using the app creation API we automatically create each one of the supported ad units (Rewarded Video, Interstitial, Banner, Offerwall) on 'Off' status - unless requested otherwise.
Authentication type
Bearer API authentication
Method
POST
platform.ironsrc.com/partners/publisher/applications/v6?
Required parameters for creating a live app
Name | Type | Description |
|---|
| String | the store URL of the app |
| String | the application sub-genre. |
| Integer | the coppa status of the application (true = 1 / false = 0) |
Required parameters for creating an app that isn't live in the store
Name | Type | Description |
|---|
| String | the application name |
| String | iOS or Android |
| Integer | the coppa status of the application (true = 1 / false = 0) |
Optional parameters
Name | Type | Description |
|---|
| String | "RewardedVideo": "Live" |
| Integer | the the ccpa status of the application (true = 1 / false = 0) |
Request example URL**
https://platform.ironsrc.com/partners/publisher/applications/v6?
Request example body for creating a live app
{ "storeUrl": "https://apps.apple.com/us/app/time-gap-hidden-objects/id661173158", "taxonomy": "puzzle", "appName": "puzzleApp", "coppa":1, "ccpa":0, "adUnits": { "RewardedVideo": "Live", "Interstitial": "Live", "OfferWall": "Off", "Banner": "Live", "NativeAd": "Live" }}
Request example body for creating an app that isn't live in the store
{ "appName": "MyTestAppiOS", "platform": "iOS"}