Get Countries List

This metadata API returns the list of all supported countries that can be used for country-level geo-targeting in deals. The API supports pagination to retrieve results in batches.

API Endpoint

GET https://apis.demand.ssp.inmobi.com/v1/meta/countries

Parameters

Headers

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

Query Parameters

Field Name	Type	Is mandatory (Y/N)?	Description
num_items	Integer	N	Number of results per page (default: 20)
page_num	Integer	N	The page number to retrieve (default: 1)

Sample Request

curl -X GET "https://apis.demand.ssp.inmobi.com/v1/meta/countries?num_items=30&page_num=2" \
-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" \

Sample Response

{
  "data": {
    "countries": [
      { "id": 150, "name": "India" },
      { "id": 108, "name": "Brazil" },
      { "id": 151, "name": "Canada" },
      { "id": 152, "name": "Netherlands" },
      { "id": 153, "name": "Bulgaria" },
      { "id": 154, "name": "Japan" },
      { "id": 155, "name": "China" }
      // ...more countries
    ],
    "pageNum": 2,
    "numItems": 30,
    "nextPage": true,
    "totalItems": 254,
    "totalPages": 9
  }
}

Last Updated on: 18 Jul, 2025

You are almost there...

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.

I AGREE

Additional Reading