تاجر جني
Which API?
Merchant API For merchants: manage your own catalogue, orders and finances through the v2 Third-Party API. Application API For partner apps: browse Gini merchants and products, send customers to checkout and follow their orders.

New: Application API docs

Pick the API you are reading here — the Merchant API for your own store, the Application API for partner apps.

Merchant dashboard
API reference
States and districts

Application API

For partner applications: browse merchants and products, hand customers a checkout link, and follow the orders it creates.

States and districts

One endpoint, two modes, for address pickers — and the canonical ids for address.state and address.city on a checkout token.

GET /api/third-party/v1/applications/states
Signed
Query parameters
Field Type Required Description
state_id integer Optional Present → that state's districts. Absent → the list of states.
GET /states
{
    "data": [
        {
            "id": 1,
            "name": "بغداد"
        },
        {
            "id": 2,
            "name": "البصرة"
        }
    ]
}
GET /states?state_id=1
{
    "data": [
        {
            "id": 10,
            "name": "الكرادة"
        }
    ]
}
Notes
  • Objects come from Gini's delivery system and may carry more fields — use the ids as the canonical values for address.state and address.city.
  • Responses are cached server-side for hours.
  • If the location source is unreachable you get 503 {'message': 'Locations are temporarily unavailable'} — retry later.