Back to Cataref

Cataref / developers

Build with the Cataref product API

Use REST for focused lookups or GraphQL for bounded reads across the catalogue. Integration documentation describes cost estimates, request keys, and access scopes.

REST / identifier lookupGET
# Synthetic example
curl 'https://cataref.com/v1/identifiers/lookup?value=9990000000012' \
  -H 'Authorization: Bearer YOUR_TEST_KEY' \
  -H 'Idempotency-Key: YOUR_REQUEST_KEY'
RESTGraphQLPython SDK

Before your first request

  1. Use your verified workspace account and scoped integration credentials.
  2. Estimate a lookup with GET /v1/billing/estimate?operation=lookup.
  3. Send your scoped credential and a unique request key. Reuse that request key when retrying an identical operation.

REST / GraphQL

The bounded read GraphQL endpoint is POST /v1/graphql. Catalogue reads require authentication and consume usage credits.

OpenAPI · OpenAPI JSON

Next steps

Use private snapshots, ordered change feeds and signed webhook deliveries.

Updated:

Explore your workspace