APIGetting Started

Versioning

Date-stamped API versions, pinned per request or per key.

The API surface is versioned with date stamps. Pin one per request with the optional SpreadSpace-Version header:

$curl https://api.spreadspace.app/api/borrowers \
>  -H "Authorization: Bearer ss_live_..." \
>  -H "SpreadSpace-Version: 2026-07-19"

Resolution order

Each request resolves its version in this order:

  1. The SpreadSpace-Version header, if sent. An invalid value returns 400 invalid_version.
  2. The API key’s pinned version, if one is set.
  3. The latest supported version.

Supported versions

  • 2026-07-19 (latest)
  • 2026-05-03

Detecting drift

Every response echoes the resolved version in the SpreadSpace-Version response header, so a client can detect drift between what it sent and what the server resolved.

Future breaking changes ship under new date stamps; existing callers keep the version they pinned.