> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yousonder.com/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> Base URL, authentication and conventions for every endpoint.

## Base URL

```text theme={null}
https://api.yousonder.com/v1
```

## Authentication

Every endpoint except [`POST /oauth/token`](/api-reference/connect/exchange-a-code-for-a-key) needs an author's API key:

```bash theme={null}
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](/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](/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.