Skip to main content

Snowday Data API

The Snowday Data API serves Snowday's curated catalog of learning opportunities over a stable, versioned REST contract. It is the supported way to read Snowday data: the underlying content platform is an implementation detail and may change without affecting this contract.

Base URL and versioning​

All endpoints are served under a path-versioned prefix:

https://api.data.snow.day/v1

Breaking changes are introduced under a new version prefix (for example /v2). Additive, backwards-compatible changes (new fields, new endpoints) ship within the current version.

Resources​

The catalog is exposed as learning opportunities. Each one carries its content together with its nested sessions, deadlines, FAQs, external reviews, and accolades, so a single read returns a complete, self-contained record.

  • GET /v1/learning-opportunities — paginated list, newest updates first.
  • GET /v1/learning-opportunities/{id} — a single learning opportunity by its stable public UUID.

See the API Reference for the full schema, query parameters, and response shapes, which are generated directly from the API contract.

Conventions​

  • Identifiers are stable public UUIDs. The API never mints new IDs; the same ID identifies the same resource everywhere.
  • Timestamps are ISO 8601 strings in UTC (for example 2026-01-15T09:30:00.000Z).
  • Errors follow RFC 7807 Problem Details and are returned as application/problem+json.
  • Pagination uses limit and offset, and list responses include the total match count so clients can page deterministically.