Locations
Locations

Download locations

Generates a CSV export of the selected locations and returns a download URL. The export runs asynchronously — the response confirms the request was accepted, and the user is notified by email when the CSV is ready.

Use selectionType to choose between all matching locations (ALL_ITEMS) or an explicit set (SELECTED_ITEMS with locationIds). The filterInput parameter accepts the same JSON-encoded filter object as Filter locations.

get/locations/download

Request

Query parameters

filterInputstring

JSON-encoded filter object. Defaults to an empty filter (all locations).

selectionType'ALL_ITEMS' | 'SELECTED_ITEMS'

Whether to export all matching locations or an explicit selection.

locationIdsstring[]

Location IDs to export when selectionType is SELECTED_ITEMS.

emailsstring[]

Email addresses to notify when the CSV is ready.

archivedboolean

Filter by archived state (true/false).

approvedboolean

Filter by approved state (true/false).

archivalScheduledAtboolean

Return only locations scheduled for archival.

Headers

Synup-Versionstring required

API version date (YYYY-MM-DD).

Authorizationstring required

API key for authentication.

Response

Successful response

Changes

No recorded changes to this operation across all 1 revision of this API.