# Logistics countries

Read JioMart logistics country metadata and codes.

- Platform: [JioMart](https://docs.upscrape.com/docs/platforms/jiomart)
- Capability ID: `jiomart.logistics.countries`
- Cost: 1 credit per request
- Maximum runtime: 30 seconds
- Execute endpoint: `POST https://data.upscrape.com/execute`

## Request

Use the exact public capability ID in the shared execute envelope.

```bash
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 '{
  "input": {},
  "capability": "jiomart.logistics.countries"
}'
```

## Input

No input is required.

This capability accepts an empty input object.

### Example input

```json
{}
```

## Response

Successful output is returned in `results[0].data`.

Country records can include names, ISO codes, currency, coordinates, phone code, hierarchy and time-zone metadata where returned.

A country appearing in this directory does not establish JioMart delivery coverage or product availability there.

### Illustrative sample output

This example shows one response. Values and optional fields vary with the data available.

```json
{
  "items": [
    {
      "currency": {
        "code": "INR",
        "name": "Indian Rupee",
        "symbol": "₹"
      },
      "display_name": "India",
      "hierarchy": [
        {
          "display_name": "Pincode",
          "slug": "pincode"
        },
        {
          "display_name": "City",
          "slug": "city"
        },
        {
          "display_name": "State",
          "slug": "state"
        }
      ],
      "id": "64aff96f9ed6a9d76597c317",
      "iso2": "IN",
      "iso3": "IND",
      "latitude": "28.6667",
      "longitude": "77.2167",
      "name": "INDIA",
      "phone_code": "+91",
      "timezones": [
        "Asia/Kolkata"
      ],
      "type": "country"
    },
    {
      "currency": {
        "code": "AED",
        "name": "United Arab Emirates Dirham",
        "symbol": "AED"
      },
      "display_name": "United Arab Emirates",
      "hierarchy": [
        {
          "display_name": "Area",
          "slug": "sector"
        },
        {
          "display_name": "City",
          "slug": "city"
        }
      ],
      "id": "6851881c34bc6fd8a2874547",
      "iso2": "AE",
      "iso3": "UAE",
      "latitude": "24.4648",
      "longitude": "54.3618",
      "name": "UNITED_ARAB_EMIRATES",
      "phone_code": "+971",
      "timezones": [
        "Asia/Dubai"
      ],
      "type": "country"
    },
    {
      "currency": {
        "code": "USD",
        "name": "United States Dollar",
        "symbol": "$"
      },
      "display_name": "United States",
      "hierarchy": [
        {
          "display_name": "Zipcode",
          "slug": "pincode"
        },
        {
          "display_name": "City",
          "slug": "city"
        },
        {
          "display_name": "State",
          "slug": "state"
        }
      ],
      "id": "6851881c34bc6fd8a2874548",
      "iso2": "US",
      "iso3": "USA",
      "latitude": "38.8951",
      "longitude": "-77.0364",
      "name": "UNITED_STATES",
      "phone_code": "+1",
      "timezones": [
        "America/New_York",
        "America/Detroit",
        "America/Kentucky/Louisville"
      ],
      "type": "country"
    }
  ],
  "raw": {
    "items": [
      {
        "currency": {
          "code": "INR",
          "name": "Indian Rupee",
          "symbol": "₹"
        },
        "display_name": "India",
        "hierarchy": [
          {
            "display_name": "Pincode",
            "slug": "pincode"
          },
          {
            "display_name": "City",
            "slug": "city"
          },
          {
            "display_name": "State",
            "slug": "state"
          }
        ],
        "id": "64aff96f9ed6a9d76597c317",
        "iso2": "IN",
        "iso3": "IND",
        "latitude": "28.6667",
        "longitude": "77.2167",
        "name": "INDIA",
        "phone_code": "+91",
        "timezones": [
          "Asia/Kolkata"
        ],
        "type": "country"
      },
      {
        "currency": {
          "code": "AED",
          "name": "United Arab Emirates Dirham",
          "symbol": "AED"
        },
        "display_name": "United Arab Emirates",
        "hierarchy": [
          {
            "display_name": "Area",
            "slug": "sector"
          },
          {
            "display_name": "City",
            "slug": "city"
          }
        ],
        "id": "6851881c34bc6fd8a2874547",
        "iso2": "AE",
        "iso3": "UAE",
        "latitude": "24.4648",
        "longitude": "54.3618",
        "name": "UNITED_ARAB_EMIRATES",
        "phone_code": "+971",
        "timezones": [
          "Asia/Dubai"
        ],
        "type": "country"
      },
      {
        "currency": {
          "code": "USD",
          "name": "United States Dollar",
          "symbol": "$"
        },
        "display_name": "United States",
        "hierarchy": [
          {
            "display_name": "Zipcode",
            "slug": "pincode"
          },
          {
            "display_name": "City",
            "slug": "city"
          },
          {
            "display_name": "State",
            "slug": "state"
          }
        ],
        "id": "6851881c34bc6fd8a2874548",
        "iso2": "US",
        "iso3": "USA",
        "latitude": "38.8951",
        "longitude": "-77.0364",
        "name": "UNITED_STATES",
        "phone_code": "+1",
        "timezones": [
          "America/New_York",
          "America/Detroit",
          "America/Kentucky/Louisville"
        ],
        "type": "country"
      }
    ],
    "page": {
      "current": 1,
      "has_next": false,
      "has_previous": false,
      "item_total": 3,
      "size": 3,
      "type": "number"
    }
  }
}
```
### Illustrative output fields

Derived from the sample above for orientation only. These fields are not a fixed response schema.

| Path | Observed type | Example |
| --- | --- | --- |
| `items` | `array` | 3 items |
| `items` | `array` | 3 items |
| `raw` | `object` | 2 fields |
| `raw.items` | `array` | 3 items |
| `raw.page` | `object` | 6 fields |

## Execution behavior

A `200` response completed inline. A `202` response was queued; poll `GET /jobs/{id}` until the job reaches `completed` or `failed`. Use an `Idempotency-Key` when retrying must not create a duplicate logical job.

## Related documentation

- [Authentication](https://docs.upscrape.com/docs/api/authentication)
- [Jobs and results](https://docs.upscrape.com/docs/api/jobs)
- [Errors and retries](https://docs.upscrape.com/docs/api/errors)
- [Idempotency](https://docs.upscrape.com/docs/api/idempotency)