Changes

Catalog changes since a release

GET/changes

Catalog releases published after after, oldest first, each with the club ids it added, updated or removed per club resource. Lists only the club resources the key can access; requires any club resource entitlement. Store the Golfapi-Catalog-Release header from any catalog response, call this with it, and refetch the listed ids. A release the change history does not cover returns 400 naming the oldest release it can answer from; rescan the catalog then.

Parameters4

Query

  • afterstringRequired

    A Golfapi-Catalog-Release value you stored.

  • limitnumber

    Releases per page.

    10Default 10
  • cursorstring

    Opaque pagination token from page.next. Send it unchanged on the same resource, with the same filters, served version and key access. Page size may change between requests. On a cursor 400, restart the scan.

Headers

  • Golfapi-Versionstring (date)

    API version. 2026-10-02 is the only version served, and the default when the header is omitted. Any other date is 400, including the retired versions GET / lists under version.retired. A malformed date is 400.

    2026-10-02Default 2026-10-02

Responses8

  • 200

    Releases after the given one.

  • 400

    Invalid recognized input or projected field.

  • 401

    Missing, malformed, unknown, or revoked key.

  • 403

    Resource/capability not granted.

  • 405

    A routed path reached by a method other than GET or OPTIONS.

  • 429

    Rate limit reached. 60 requests per 60-second wall-clock window by default; RateLimit-Limit carries this key’s actual cap. Honor Retry-After, which equals RateLimit-Reset.

  • 500

    Server fault.

  • 503

    Required representation or schema unavailable; honor Retry-After.

Response schema3 fields

  • afterstringRequired
  • dataCatalogRelease[]Required
  • pageobjectRequired

This page as Markdown