Get States List

This metadata API returns the list of states or regions available under a specific country. It is typically used when setting up state-level geo-targeting during deal creation or update.

API Endpoint

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

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
country_id	Integer	Y	The ID of the country to filter cities by

Sample Request

curl -X GET "https://apis.demand.ssp.inmobi.com/v1/meta/states?country_id=108" \
-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": {
    "states": [
      {
        "id": 31328,
        "name": "ACRE",
        "countryName": "Brazil",
        "countryId": 108
      },
      {
        "id": 31300,
        "name": "ALAGOAS",
        "countryName": "Brazil",
        "countryId": 108
      },
      {
        "id": 31301,
        "name": "AMAPA",
        "countryName": "Brazil",
        "countryId": 108
      }
      // ...more states
    ],
    "pageNum": 1,
    "numItems": 20,
    "nextPage": true,
    "totalItems": 39,
    "totalPages": 2
  }
}

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