API reference - Sonder Docs

Base URL

https://api.yousonder.com/v1

Authentication

Every endpoint except POST /oauth/token needs an author’s API key:

curl https://api.yousonder.com/v1/account \
  -H "Authorization: Bearer sonder_live_YOUR_KEY"

Paste a key into the playground on any endpoint page to try it against real data. See Authentication for where keys come from.

Responses

Successful responses have "success": true and the result in data. Lists that page return has_more and next_cursor: pass next_cursor back as cursor (or after, for events) to get the next page. Failed responses have "success": false and an error with a code and a message. See Errors.

Conventions

Field names are snake_case.
Times are ISO 8601 in UTC; dates are YYYY-MM-DD in UTC.
IDs are UUIDs, except event IDs (evt_1043), which increase over time.
New fields may be added to responses at any time; don’t fail on fields you don’t recognise.