New: Application API docs
Pick the API you are reading here — the Merchant API for your own store, the Application API for partner apps.
For partner applications: browse merchants and products, hand customers a checkout link, and follow the orders it creates.
One endpoint, two modes, for address pickers — and the canonical ids for address.state and address.city on a checkout token.
/api/third-party/v1/applications/states
| Field | Type | Required | Description |
|---|---|---|---|
state_id
|
integer | Optional | Present → that state's districts. Absent → the list of states. |
{
"data": [
{
"id": 1,
"name": "بغداد"
},
{
"id": 2,
"name": "البصرة"
}
]
}
{
"data": [
{
"id": 10,
"name": "الكرادة"
}
]
}