# Getting started

# Getting Started

The official Collectors Club API. REST over HTTPS, JSON only, base path `/v1`.

Authenticate with an API key in the `Authorization` header:
`Authorization: Bearer sk_test_...`. Publishable keys (`pk_`) can read
public data; secret keys (`sk_`) can do everything their scopes allow.
Test-mode keys (`*_test_`) operate on the sandbox dataset and never touch
real inventory or real money.

Every response carries a `Request-Id` header. Include it when contacting
support. Every `POST` accepts an `Idempotency-Key` header; replays within
24 hours return the original response.

## Your first request

```bash
curl https://packs.collectorsclub.com/v1/ping -H "Authorization: Bearer sk_test_..."
```

## Orient in one call

`GET https://packs.collectorsclub.com/v1` returns a capability document (no auth required): available resources, current version (`2026-08-04`), docs URL, spec URL, and rate limits.

## Machine-readable spec

- OpenAPI (JSON): https://packs.collectorsclub.com/openapi.json (version-pinned copy: https://packs.collectorsclub.com/v1/openapi.json)
- OpenAPI (YAML): https://packs.collectorsclub.com/openapi.yaml
- All docs as one file: https://packs.collectorsclub.com/docs/llms-full.txt

Every docs page is also raw markdown: append `.md` to the URL, or send
`Accept: text/markdown`. Prefer the markdown form for content without HTML navigation.

