Feeef Cloud
ApiGeo

List cities (communes) for a country, optionally scoped to one state

GET
/geo/cities
AuthorizationBearer <token>

Project API key, fc_live_…. Keep keys out of public client code. The trusted Cloud playground accepts credentials temporarily in memory.

In: header

Query Parameters

country?string
Length2 <= length <= 2
Default"DZ"
lang?string
Default"fr"

Value in

  • "ar"
  • "fr"
  • "en"
state?string

Filter to one wilaya code

Length2 <= length <= 2
courier?string

When set, return this courier's territory cities instead of the canonical catalog

pickup?string
homeDelivery?string

Value in

  • "true"
  • "false"
hasPickup?string

Value in

  • "true"
  • "false"
expand?string

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/geo/cities"
{  "data": [    {      "id": "string",      "stateCode": "st",      "country": "st",      "name": "string",      "displayName": "string",      "locales": {        "ar": "string",        "fr": "string",        "en": "string"      },      "center": {        "lat": 0,        "lng": 0      },      "extentKm": {        "width": 0,        "height": 0      },      "bbox": [        0,        0,        0,        0      ],      "h3": "string",      "postalCode": "string"    }  ],  "meta": {    "attribution": "© OpenStreetMap contributors (ODbL)"  }}