Use the API to retrieve a paginated list of all deals associated with your organization. Supports optional filters by status, partner, or keyword search.
Support Center
GET https://apis.demand.ssp.inmobi.com/v1/deals
| Field Name | Type | Is mandatory (Y/N)? | Description |
|---|---|---|---|
| Authorization | String | Y | Bearer token for authentication (Bearer <token>) |
| X-USER-ID | String | Y | The ID of the user making the request |
| X-INMOBI-ORG-ID | String | Y | The organization ID associated with the user |
| Content-Type | String | Y | Specifies the media type of the request body. Use: application/json |
| Field Name | Type | Is mandatory (Y/N)? | Description |
|---|---|---|---|
search |
String | Optional | Search by dealId, dealName, or seatId |
status |
String | Optional | Filter by deal status: ACTIVE, PAUSED, EXPIRED, UPCOMING |
partner |
String | Optional | Filter deals by partner name |
pageNum |
Integer | Optional (default = 1) | Page number for pagination |
numItems |
Integer | Optional (default = 20) | Number of items per page |
You must include the standard headers: Authorization, X-USER-ID, and X-INMOBI-ORG-ID.
curl -X GET "https://apis.demand.ssp.inmobi.com/v1/deals" \
-H "Authorization: Bearer <your bearer token>" \
-H "X-USER-ID: <test app>" \
-H "X-INMOBI-ORG-ID: <your org id>" \
-H "Content-Type: application/json"
{
"data": {
"deals": [
{
"name": "testdeal1",
"id": "4263509453",
"seats": [
{
"id": "seat1"
}
],
"endDate": "2025-07-18T23:59:59",
"status": "UPCOMING"
},
{
"name": "testdeal2",
"id": "4263509452",
"seats": [
{
"id": "seat1"
}
],
"endDate": "2025-07-18T23:59:59",
"status": "UPCOMING"
}
]
}
}
For more information, see Error Codes.
By installing this SDK update, you agree that your Children Privacy Compliance setting remains accurate or that you will update that setting, whenever there is a change in your app's audience. You may update the app's Children Privacy Compliance settings at https://publisher.inmobi.com/my-inventory/app-and-placements.