GET /client/geofences

Get all geofences in an account.

Returns a paginated list of all geofences for the specified company. This is the GA API endpoint designed for mobile SDK consumption. No authentication required.

Returns a maximum of 100 results per page (default 20).

This API supports filtering via header instead of query param. Provide X-Klaviyo-API-Filters header to filter geofences. We don't use regular query param filters here because lat and long are sensitive information.

Supported filters:

When both lat and lng are provided, geofences are returned sorted by distance from the specified coordinates (closest first).

Example filter header: X-Klaviyo-API-Filters: and(equals(lat,40.7128),equals(lng,-74.0060))

Rate limits:
Burst: 3/s
Steady: 60/m

OpenAPI Spec

Servers

Request headers

Name Type Required Description
revision String Yes

API endpoint revision (format: YYYY-MM-DD[.suffix])

Default value: "2026-04-15"

X-Klaviyo-API-Filters String No

Supported filters:

  • lat (equals) - Latitude coordinate for distance-based sorting
  • lng (equals) - Longitude coordinate for distance-based sorting

When both lat and lng are provided, geofences are returned sorted by distance from the specified coordinates (closest first).

Query parameters

Name Type Required Description
page[cursor] String No

For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#pagination

fields[geofence][] Array No

For more information please visit https://developers.klaviyo.com/en/v2026-04-15/reference/api-overview#sparse-fieldsets

page[size] Integer No

Default: 20. Min: 1. Max: 100.

Default value: 20

company_id String Yes

Your Public API Key / Site ID. See this article for more details.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.