Skip to main content

ListCities lists cities, optionally filtered by country.

GET 
/api/v1/engagements/contacts/cities

Cities are global reference data linked to countries. Used for contact address and CRM city classification.

Pagination​

  • page: Page number (default: 1)
  • per_page: Results per page (default: 20, max: 100)

Filtering​

  • country_id: Filter to cities in specific country
  • search: Filter by city name (partial match)

Response​

Returns paginated list of cities sorted alphabetically.

Errors​

  • PERMISSION_DENIED: Caller lacks contacts:read permission

Request​

Responses​

A successful response.