Groups API v3

Use this API to manage mediation groups on the LevelPlay dashboard. The API supports the following:

• Managing mediation groups setup
• Managing WaterFalls per mediation group

Requests are limited to 1 application per call.

Rate limits

The API returns a 429 HTTP status code if a request exceeds 4000 requests in a time period of 30 minutes.

Authentication Type

Bearer API authentication

Request Example URL

https://platform.ironsrc.com/levelPlay/groups/v3/[APP_KEY]/

GET

Get the list of your application groups. 

Request Parameters

Response Parameters

Response Example 

[
  {
	 "id": 12673,
 "adUnit": "rewardedVideo",
 "abTest" "A",
 	 "name": "newGroup",      
 "countries": ['FR', 'US'],
	 "position": 1,
      "segments": [],
	 "floorPrice?": 0.3,
	 "instances": [
{
  "id": 3681,
  "name": "Default",
  "networkName": "ironSource"
},
{
   "id": 2,
   "name": "Default"
   "isBidder": false,
   "tierPosition?": 2,
   "networkName": "AdColony",
   "groupRate?": 5,
   "capping?": 1,
   "countriesRate: [{
	"countryCode": "FR"
	"rate": 1
   }]
      }
  ]
   }
]

CREATE

Description
Use this API to create mediation groups. This API allows you to create multiple groups with a single API call. Use the “instances” parameter to determine each instance to include/exclude in a group. The instance ID value is reachable using the Instances API.

Note:

1. This API allows you to create multiple groups with a single API call.
2. The Group Id value is reachable using Get call to this API
3. The instance ID value is reachable using the Instances API.

Request Parameters

Request Example 

[
  {
 	 "name": "new group",      
 "adUnit": "rewardedVideo",
	 "countries": ["FR", "US"],
	 "position": 1,
      "segments?": [nonPaying],
	 "abTest?": "B",
	 "floorPrice?": 0.3,
	 "instances?": [
{
  "id": 7983541,
  "tierPosition?": 2,
  "groupRate?": 2,
  "capping?": 4,
  "countriesRate?: [{
	"countryCode": "FR",
	"rate": 1
   }]
},
{
	"id": 4896357,
 },
{
  "id": 62624583,
  "tierPosition?": 1,
  "countriesRate?: [{
	"countryCode": "US",
	"rate": 5.3
   }]
}
  ]
   }
]

UPDATE

Description

Use this API to update mediation groups setup configuration and waterfalls

Notes:

1. Multiple groups can be updated with a single API call
2. To remove the groupRate/countryRate, simply add the field parameter with null value.
3. To remove the capping, simply add the field parameter with null value.
4. To update an array field, include all values (new and existing).

Supported Parameters

Request Example

[
  {
	 "id": 123,
 	 "name?": "new group",      
 "countries?": ['FR', 'US'],
	 "position?": 1,
      "segments?": [],
	 "floorPrice?": 0.3,
	 "instances?": [
{
  "id": 1  "tierPosition?": 1,
  "groupRate?": null,
  "capping?": null,
  "countriesRate: [{
	"countryCode": "FR"
	"rate": 1
   }]
},
{
  "id": 2
  "tierPosition?": 1,
  "countriesRate: [{
	"countryCode": "FR"
	"rate": 1.4
   }]
}
  ]
   }
]

Success

A successful response will be sent with HTTP code 200.

DELETE

Description

Use this API to delete an instance.

Notes:

1. The AllCountries group cannot be deleted.
2. Deleted groups cannot be restored.

Required Parameters

Request body example

[
  {
      "ids": [1458, 5769]
  }
]

Success

A successful response will be sent with HTTP code 200.

Errors

If one of the groups sent in the request is failing, an error array will be sent with HTTP code 400 and will cause the whole request to be rejected.

Each error will be followed with an error message.

Example

{
    "errorsArray": [
        {
            "code": ERR-208,
            "errorMessage": "Group name value is required",
            "params": {
                "[0].name": ""
            }
        },
        {
            "code": ERR-311,
            "errorMessage": "Group position value is not valid",
            "params": {
                "[0].position": ""
            }
        }
    ],
    "code": 400
}