Matchplat API Docs

GET /utils/regions

Returns the list of available regions for a given country.

Query parameters

Field Type Required Description
countryIso2 String ✔ ISO2 code of the country (required)

Response 200

Field Type Description
typeOfRegion String Type of administrative division (e.g. "Region|Province")
regions String[] List of available regions

Example

{
  "typeOfRegion": "Region|Province",
  "regions": [
    "Lombardia|Milano",
    "Lazio|Roma",
    "Sicilia|Palermo"
  ]
}

Example curl call

curl -X GET "/utils/regions?countryIso2=IT" \
  -H "x-api-key: <API_KEY>"

Other codes

400

countryIso2 missing or invalid