JioMart API reference

JioMart Logistics Countries

jiomart.logistics.countries

Read the countries in JioMart's delivery directory, with their codes.

JioMart Logistics Countries API: overview and live sample

At a glance

Endpoint ID: jiomart.logistics.countries
Price: 1 credit per call; failed calls are free
Runs for up to: 30 seconds
Request: POST /execute; Run an endpoint
MCP tool when pinned: jiomart__logistics__countries; Pin tools
OpenAPI: openapi.json; Download

Request

Send the endpoint ID as capability and its fields as input. Set UPSCRAPE_API_KEY to your key first.

curl --request POST \  --url https://data.upscrape.com/execute \  --header "Authorization: Bearer $UPSCRAPE_API_KEY" \  --header "Content-Type: application/json" \  --header "Prefer: wait=30" \  --data '{  "capability": "jiomart.logistics.countries",  "input": {}}'

import jsonimport osimport requestspayload = json.loads(r'''{  "capability": "jiomart.logistics.countries",  "input": {}}''')response = requests.post(    "https://data.upscrape.com/execute",    headers={        "Authorization": f"Bearer {os.environ['UPSCRAPE_API_KEY']}",        "Content-Type": "application/json",        "Prefer": "wait=30",    },    json=payload,)response.raise_for_status()print(json.dumps(response.json(), indent=2))

const response = await fetch("https://data.upscrape.com/execute", {  method: "POST",  headers: {    "Authorization": `Bearer ${process.env.UPSCRAPE_API_KEY}`,    "Content-Type": "application/json",    "Prefer": "wait=30",  },  body: JSON.stringify({  "capability": "jiomart.logistics.countries",  "input": {}}),});if (!response.ok) {  throw new Error(`Upscrape request failed: ${response.status}`);}console.log(JSON.stringify(await response.json(), null, 2));

Input

This endpoint takes an empty input object.

Response

A finished call answers with HTTP 200; the data is in results[0].data, and billing.credits_charged is what it cost. A call still running after the wait answers 202: see jobs and results.

This is results[0].data from a real run:

results[0].data

{  "raw": {    "page": {      "current": 1,      "has_next": false,      "has_previous": false,      "item_total": 3,      "size": 3,      "type": "number"    },    "items": [      {        "name": "INDIA",        "display_name": "India",        "id": "64aff96f9ed6a9d76597c317",        "iso2": "IN",        "iso3": "IND",        "latitude": "28.6667",        "longitude": "77.2167",        "phone_code": "+91",        "type": "country",        "currency": {          "name": "Indian Rupee",          "code": "INR",          "symbol": "₹"        },        "hierarchy": [          {            "display_name": "Pincode",            "slug": "pincode"          },          {            "display_name": "City",            "slug": "city"          }        ],        "timezones": [          "Asia/Kolkata"        ]      },      {        "name": "UNITED_ARAB_EMIRATES",        "display_name": "United Arab Emirates",        "id": "6851881c34bc6fd8a2874547",        "iso2": "AE",        "iso3": "UAE",        "latitude": "24.4648",        "longitude": "54.3618",        "phone_code": "+971",        "type": "country",        "currency": {          "name": "United Arab Emirates Dirham",          "code": "AED",          "symbol": "AED"        },        "hierarchy": [          {            "display_name": "Area",            "slug": "sector"          },          {            "display_name": "City",            "slug": "city"          }        ],        "timezones": [          "Asia/Dubai"        ]      }    ]  },  "items": [    {      "name": "INDIA",      "display_name": "India",      "id": "64aff96f9ed6a9d76597c317",      "iso2": "IN",      "iso3": "IND",      "latitude": "28.6667",      "longitude": "77.2167",      "phone_code": "+91",      "type": "country",      "currency": {        "name": "Indian Rupee",        "code": "INR",        "symbol": "₹"      },      "hierarchy": [        {          "display_name": "Pincode",          "slug": "pincode"        },        {          "display_name": "City",          "slug": "city"        }      ],      "timezones": [        "Asia/Kolkata"      ]    },    {      "name": "UNITED_ARAB_EMIRATES",      "display_name": "United Arab Emirates",      "id": "6851881c34bc6fd8a2874547",      "iso2": "AE",      "iso3": "UAE",      "latitude": "24.4648",      "longitude": "54.3618",      "phone_code": "+971",      "type": "country",      "currency": {        "name": "United Arab Emirates Dirham",        "code": "AED",        "symbol": "AED"      },      "hierarchy": [        {          "display_name": "Area",          "slug": "sector"        },        {          "display_name": "City",          "slug": "city"        }      ],      "timezones": [        "Asia/Dubai"      ]    }  ]}

Fields

Field	Type	What it is	Example
`items[].currency.name`	string	Product, brand, department, collection or content name as returned for the selected endpoint.	Indian Rupee
`items[].name`	string	Product, brand, department, collection or content name as returned for the selected endpoint.	INDIA
`items[].display_name`	string	Readable location or country name returned by location or logistics metadata.	India
`items[].hierarchy[].display_name`	string	The address level's name, such as Pincode or City.	Pincode
`items[].currency`	object	Currency of the price, usually INR where a product price is present.	3 fields
`items[].currency.code`	string	The country's currency code, such as INR.	INR
`items[].currency.symbol`	string	The currency symbol.	₹
`items[].hierarchy`	array	The address levels used in the country, such as PIN code and city.	3 records
`items[].hierarchy[].slug`	string	The address level's code, such as pincode.	pincode
`items[].id`	string	JioMart's ID for the country.	64aff96f9ed6a9d76597c317
`items[].iso2`	string	Two-letter country code.	IN
`items[].iso3`	string	Three-letter country code.	IND
`items[].latitude`	string	Latitude of the place.	28.6667
`items[].longitude`	string	Longitude of the place.	77.2167
`items[].phone_code`	string	The country's phone code.	+91
`items[].timezones`	array	The country's time zones.	Asia/Kolkata
`items[].type`	string	The kind of record or suggestion, where JioMart gives one.	country
`items`	array	The entries returned.	3 records
`raw`	object	JioMart's own response, as it came back.	2 fields
`raw.items`	array	The entries returned.	3 records
`raw.items[].currency`	object	The country's currency: code, name and symbol.	3 fields
`raw.items[].display_name`	string	The country's name, such as India.	India
`raw.items[].hierarchy`	array	The address levels used in the country, such as PIN code and city.	3 records
`raw.items[].id`	string	JioMart's ID for the country.	64aff96f9ed6a9d76597c317
`raw.items[].iso2`	string	Two-letter country code.	IN
`raw.items[].iso3`	string	Three-letter country code.	IND
`raw.items[].latitude`	string	Latitude of the country's capital, as listed.	28.6667
`raw.items[].longitude`	string	Longitude of the country's capital, as listed.	77.2167
`raw.items[].name`	string	The country's name in capitals, such as INDIA.	INDIA
`raw.items[].phone_code`	string	The country's phone code.	+91
`raw.items[].timezones`	array	The country's time zones.	Asia/Kolkata
`raw.items[].type`	string	The kind of place, such as country.	country
`raw.page`	object	The page the entry opens, or this response's page details.	6 fields
`raw.page.current`	integer	The current page number.	1
`raw.page.has_next`	boolean	Whether another page follows.	false
`raw.page.has_previous`	boolean	Whether a page comes before this one.	false
`raw.page.item_total`	integer	How many entries there are in total.	3
`raw.page.size`	integer	How many entries each page holds.	3
`raw.page.type`	string	The kind of record or suggestion, where JioMart gives one.	number

What to know

Country records can include names, ISO codes, currency, coordinates, phone code, parent region and time zone, where returned.
A country in this directory does not mean JioMart delivers there or that products are available there.

If a call fails

A failed call costs nothing. The response carries an error.code you can branch on; Errors and retries lists every code and which ones to retry.

Other JioMart endpoints

Something missing or unclear? Ask the team that builds the JioMart endpoints.