# API overview

> Base URL, authentication, scopes and conventions of the SNDR API.

Source: https://sndr.sh/docs/api-reference

The SNDR API is plain HTTPS and JSON. Every request goes to the same base URL:

```text
https://api.sndr.sh/v1
```

## Authentication

Send your API key as a Bearer token. Keys look like `sndr_live_...` and are created in **API keys** in the dashboard.

```bash
curl https://api.sndr.sh/v1/emails \
  -H "Authorization: Bearer $SNDR_API_KEY"
```

> **Warning:** Keep keys on your server. Never put them in browser or mobile code.

## Scopes

| Scope | Allows |
| --- | --- |
| `read` | All `GET` endpoints. |
| `send` | Sending and every create, update or delete. |

API keys can list keys but not create or delete them. That is done in the dashboard only.

## Pagination

Paginated lists take `limit` (default 50, max 200) and `cursor`. Pass the `next_cursor` from one page to get the next, while `has_more` is `true`.

```json
{
  "data": [ ... ],
  "next_cursor": "eyJ0cyI6...",
  "has_more": true,
  "count": 50,
  "limit": 50
}
```

## Errors

Failed requests return an HTTP error status and an `error` object. See [Errors](https://sndr.sh/docs/errors) for every code.

## Endpoints

- [Emails](https://sndr.sh/docs/api/emails): Send and look up emails.
- [Domains](https://sndr.sh/docs/api/domains): Add and verify sending domains.
- [Templates](https://sndr.sh/docs/api/templates): Reusable subjects and bodies.
- [Contacts](https://sndr.sh/docs/api/contacts): Your audience for broadcasts.
- [Webhooks](https://sndr.sh/docs/api/webhooks): Event endpoints and signing keys.
- [Analytics](https://sndr.sh/docs/api/analytics): Sends, deliveries, bounces and complaints.
