# SpaceCare Public API

> A bearer-authenticated, scoped, owner-scoped REST API that lets approved partners read their own courses and module headers from their own systems.

The REST API is served from `https://space.care/api/v1`. Authenticate every request with an `Authorization: Bearer <key>` header. Responses use the envelope `{ data, meta? }`; failures use `{ error: { code, message } }` - branch on the machine-stable `error.code`.

## Documentation

- [Interactive API reference](https://docs.space.care): the full Scalar reference (browser).
- [OpenAPI 3.1 specification](https://docs.space.care/openapi.json): machine-readable contract (public, no auth).
- [API reference (Markdown)](https://docs.space.care/openapi.md): every endpoint and schema as plain text.

## Getting started

- [Mint a scoped API key](https://space.care/settings?tab=developers): sign in to SpaceCare and create a bearer token, granting only the scopes your integration needs.

## Scopes

- `read:profile`: verify a credential and read back its identity and scopes.
- `read:courses`: list and read your own courses and module headers (never module bodies).