# TreasurySpring Event Checkpoints API

**Canonical:** https://apis.io/apis/treasuryspring/treasuryspring-event-checkpoints-api/  
**Provider:** TreasurySpring — https://apis.io/providers/treasuryspring/  
**Base URL:** https://api.treasuryspring.com/api/v1  
**Documentation:** https://docs.treasuryspring.com/

TreasurySpring Event Checkpoints API is one of 13 APIs that [TreasurySpring](https://apis.io/providers/treasuryspring/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Event Checkpoints. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

Server-managed cursors for stateless event stream consumers. In most cases, checkpoints are not needed. If your system can persist data locally (e.g. in a database, file, or key-value store), store the `cursor` value from `GET /event` yourself and pass it as `start_cursor` on the next request. **When to use checkpoints:** Use this endpoint if your system runs in an environment that cannot reliably persist state between invocations — for example, a stateless function, a script with no backing store, or a system that delegates position tracking to TreasurySpring entirely. A checkpoint is a named record stored server-side that remembers where your last successful sync run ended. Instead of storing the cursor yourself, you store it here and retrieve it at the start of each sync run: 1. **Create** a checkpoint once: `PUT /event/checkpoint/{name}` — the cursor is initialised to the current end of the event stream. 2. **Read** the checkpoint at the start of each sync run: `GET /event/checkpoint/{name}` → `cursor`, `checkpointVersion`. 3. **Fetch events** from that cursor: `GET /event?start_cursor={cursor}`. 4. **Advance** the checkpoint after successful processing: `PATCH /event/checkpoint/{name}` with `expectedCheckpointVersion` and `newCursor`. The `checkpointVersion` acts as a safety check — if another process has already advanced the checkpoint since you last read it, the request returns a 409 Conflict with the current state so you can reconcile before retrying. Checkpoints are scoped to the authenticated API user.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/treasuryspring/refs/heads/main/openapi/treasuryspring-event-checkpoints-api-openapi.yml
- **Documentation** — https://docs.treasuryspring.com/
- **APIReference** — https://docs.treasuryspring.com/api-reference

## Other TreasurySpring APIs (12)

- [TreasurySpring Calendar API](https://apis.io/apis/treasuryspring/treasuryspring-calendar-api/)
- [TreasurySpring Cells API](https://apis.io/apis/treasuryspring/treasuryspring-cells-api/)
- [TreasurySpring Entities API](https://apis.io/apis/treasuryspring/treasuryspring-entities-api/)
- [TreasurySpring Events API](https://apis.io/apis/treasuryspring/treasuryspring-events-api/)
- [TreasurySpring Healthcheck API](https://apis.io/apis/treasuryspring/treasuryspring-healthcheck-api/)
- [TreasurySpring Holdings API](https://apis.io/apis/treasuryspring/treasuryspring-holdings-api/)
- [TreasurySpring Indications API](https://apis.io/apis/treasuryspring/treasuryspring-indications-api/)
- [TreasurySpring OAuth API](https://apis.io/apis/treasuryspring/treasuryspring-oauth-api/)
- [TreasurySpring Obligor Exposure API](https://apis.io/apis/treasuryspring/treasuryspring-obligor-exposure-api/)
- [TreasurySpring Subscriptions API](https://apis.io/apis/treasuryspring/treasuryspring-subscriptions-api/)
- [TreasurySpring Tasks API](https://apis.io/apis/treasuryspring/treasuryspring-tasks-api/)
- [TreasurySpring Webhooks API](https://apis.io/apis/treasuryspring/treasuryspring-webhooks-api/)

## Tags

Event Checkpoints

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/treasuryspring/treasuryspring-event-checkpoints-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/treasuryspring/.