API Reference

The Catalogian REST API lets you query sources, delta events, and row-level changes. Every endpoint authenticates with an API key; the dashboard itself uses your signed-in session.

Authentication

Account keys are created in the dashboard under Settings → Developers; record-scoped keys live on a record's Connect tab (Record API Keys). Pass the key as a Bearer token:

Authorization: Bearer <key>

Scopes:

• full: everything, including creating records and managing keys
• read: sources, delta events, row data, and downloads
• download: snapshot exports only

Record-scoped keys

A record-scoped key (cat_src_...) automatically resolves to its record, no record ID needed in the URL. Use the record slug anywhere a :id appears:

GET /v1/sources/west-coast-earthquakes/snapshot-rows
Authorization: Bearer cat_src_...

Tip: GET /v1/sources with a record-scoped key returns only the scoped record, no ID or slug param needed.

List sources

GET https://api.catalogian.com/v1/sources
Authorization: Bearer <key>

Response:

[
  {
    "id": "cmmfyryl30005ygld7m5596gm",
    "name": "West Coast Earthquakes",
    "type": "http",
    "status": "active",
    "keyField": "id",
    "format": "csv",
    "url": "https://earthquake.usgs.gov/earthquakes/feed/v1.0/summary/all_day.csv",
    "lastCheckedAt": "2026-09-28T20:00:00.000Z",
    "checkIntervalMinutes": 60
  }
]

Get delta events

GET https://api.catalogian.com/v1/sources/:id/delta
Authorization: Bearer <key>

Query parameters:

Param	Description
`since`	ISO 8601 timestamp — only return events after this time
`limit`	Max results (default 50, max 200)
`cursor`	Pagination cursor from previous response
`keysLimit`	Max keys per category (default 100, max 1000)

Response:

{
  "sourceId": "cmmfyryl30005ygld7m5596gm",
  "count": 2,
  "hasMore": false,
  "nextCursor": null,
  "events": [
    {
      "id": "evt_01j...",
      "detectedAt": "2026-09-28T20:00:00.000Z",
      "newCount": 5,
      "changedCount": 3,
      "deletedCount": 1,
      "unchangedCount": 193,
      "totalCount": 202,
      "isNoChange": false,
      "newKeys": ["nc75443740", "nc75443741"],
      "changedKeys": ["nc75443737"],
      "deletedKeys": ["nc75443001"]
    }
  ]
}

Get latest delta event

GET https://api.catalogian.com/v1/sources/:id/delta/latest
Authorization: Bearer <key>

Same response shape as above but returns a single event object, not an array.

Get delta rows

Changed row data — before/after values for each affected row.

GET https://api.catalogian.com/v1/sources/:id/delta/:deltaEventId/rows
Authorization: Bearer <key>   (requires the read or full scope)

Query parameters:

Param	Description
`changeType`	`new` \| `changed` \| `deleted`
`limit`	Max results per page
`cursor`	Pagination cursor from previous response

Response includes before/after values for each changed row.

Errors

Standard HTTP status codes. Error body:

{ "error": "Human-readable message" }

Status	Meaning
401	Unauthorized — missing or invalid API key
403	Forbidden — API key lacks required scope
404	Not Found — source or event doesn't exist
429	Too Many Requests — rate limit exceeded