API Reference

Get states

get
https://prospect-api.smartlead.ai/api/v1/search-email-leads/states

Returns paginated list of states for the authenticated user. Optional search string to match state names starting with the value. Optional filter by country name(s) (comma-separated values). Requires authentication via Bearer token or API key in query (?api_key=...).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

API key for authentication. Without it, the request returns 401 Unauthorized.

string
Defaults to 10

Number of states to return (1–100). Default 10.

string
Defaults to 0

Number of states to skip for pagination (≥ 0). Default 0.

string
length between 1 and 255

Search string to match state names starting with this value (1–255 chars).

string
length between 1 and 255

Filter by country name(s). Comma-separated values (e.g. india,usa,canada). 1–255 chars.

Responses

Updated 3 months ago

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 3 months ago