# McCormick Theological Seminary API sandbox

> A test environment for the [McCormick Theological Seminary API](https://mccormick.relayto.com/developers): the same operations, over fixed sample data instead of this site's content.

- Sandbox base URL: `https://mccormick.relayto.com/api/site/sandbox/v1`
- Live base URL: `https://mccormick.relayto.com/api/site/v1`
- Authentication: none, as on the live API.
- OpenAPI: <https://mccormick.relayto.com/openapi.json> (the sandbox is its second server)

## What it holds

An imaginary company, Example Industries (sandbox). Its records never change, so tests can expect exact answers. Nothing in it is content of mccormick.relayto.com.

| Slug | Kind | What to expect |
| --- | --- | --- |
| `home` | page | 200, the home page |
| `annual-reports` | hub | 200, 2 public items |
| `investor-presentations` | hub | 200, 1 public items |
| `annual-report-2025` | content | 200, full text (`access: open`) |
| `annual-report-2024` | content | 200, full text (`access: open`) |
| `q3-2025-results-presentation` | content | 200, full text (`access: open`) |
| `sustainability-review-2025` | content | 200, full text (`access: open`) |
| `capital-markets-day-2025` | content | 200 with `access: email-gated`: description only, as for a document behind an email form |
| `board-pack-2025` | content | 403 with code `not_public`, as for a private document; never listed |
| anything else | | 404 with code `not_found` |

## Try it

```bash
curl "https://mccormick.relayto.com/api/site/sandbox/v1/contents?limit=2"
curl "https://mccormick.relayto.com/api/site/sandbox/v1/search?q=annual+report"
curl "https://mccormick.relayto.com/api/site/sandbox/v1/contents/board-pack-2025"
curl -i -X POST "https://mccormick.relayto.com/api/site/sandbox/v1/exports" -H "Content-Type: application/json" -H "Idempotency-Key: $(uuidgen)" -d '{"hub": "annual-reports"}'
```

Pagination, errors, rate limits and export jobs behave exactly as on the live API; see the [developer documentation](https://mccormick.relayto.com/developers). Sandbox export ids only work in the sandbox.
