Get locations typeahead suggestions scoped by country code (v1)

On the existing API at https://api.casafari.com (contract clients): send Authorization: Bearer $CASAFARI_TOKEN; see how to get a token. New users: the platform's REST API, platform API keys.

Over MCP: no tool does this. MCP and REST compared.

#Description

Returns location typeahead suggestions within the given country (ES or PT).

#Request body

Content type application/json. Optional. Type: object.

#Example request

Placeholders only: replace the token and the values with your own.

curl -X POST "https://api.casafari.com/api/v1/references/locations/typeahead" \
  -H "Authorization: Bearer $CASAFARI_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "country_codes": [
    "PT"
  ],
  "name": "lisboa",
  "lang": "en",
  "size": 30
}'

#Responses

#200 OK

Type: object.

{
  "typeahead": [
    {
      "location_id": 1296,
      "name": "Lisboa",
      "matched_name": "Lisboa",
      "administrative_level": "Distrito",
      "breadcrumbs": [
        {
          "location_id": 499,
          "name": "Portugal"
        },
        {
          "location_id": 1296,
          "name": "Lisboa"
        }
      ]
    }
  ]
}

#401 Unauthorized

Type: object.

#403 Forbidden

Type: object.

#Questions about this

• Which countries does Casafari cover?
• How do I turn a place name into a location id?

#Related pages

• Get agencies (v1) (GET /api/v1/references/agencies)
• Get agents (v1) (GET /api/v1/references/agents)
• Get conditions (v1) (GET /api/v1/references/conditions)
• Get features (v1) (GET /api/v1/references/features)
• References REST API: all operations
• How to get a bearer token for the Casafari REST API
• MCP vs REST API compared