Skip to main content
GET
This endpoint requires authentication via API key passed as a query parameter (api_key).

Query Parameters

string
required
Your SmartLead API key for authentication
string
Number of cities to return (1–100). Pattern: ^[1-9][0-9]*$ or 100. Default: “10”.
string
Number of cities to skip for pagination (≥ 0). Pattern: ^[0-9]+$. Default: “0”.
Search string to match city names starting with this value (1–255 characters).
string
Filter by state name(s). Comma-separated values (e.g. california,texas,florida). 1–255 chars.
string
Filter by country name(s). Comma-separated values (e.g. usa,canada). Requires state. 1–255 chars.

Response Codes

Success
Request successful
Unauthorized
Unauthorized
Internal Server Error
Internal Server Error