Markets

List catalog changes

GET
/catalog/changes

Authorization

appId
headerx-app-id<token>

Your application ID. Required on app-tier and user-tier routes. Omitted on routes that authenticate with x-app-api-key only.

Query Parameters

since?string

Start of the walk (ISO). Required unless cursor is sent. At most 24 hours ago — older positions get 410 and a full resync via the list endpoints.

Formatdate-time
cursor?string

nextCursor from the previous page. Takes precedence over since.

limit?number
Range1 <= value <= 500
Default200
venues?array<>|
entities?array<>||

Response Body

200

application/json
  1. response
data*array<>
nextCursor*string

Always set. Pass it back to continue — including after hasMore is false, to poll from where you stopped.

hasMore*boolean

More changes are already available. A page can hold fewer than limit items (or none) while this is true.

Example Request
curl -X GET 'https://api.t.sufwankhalid.com/catalog/changes'
Example Response
{  "data": [    {      "entity": "event",      "id": "string",      "op": "created",      "version": 0,      "changedAt": "2019-08-24T14:15:22Z",      "venue": "string",      "event": {        "id": "string",        "venue": "string",        "externalIdentifier": "string",        "title": "string",        "slug": "string",        "status": "string",        "startDate": "2019-08-24T14:15:22Z",        "endDate": "2019-08-24T14:15:22Z",        "createdAt": "2019-08-24T14:15:22Z",        "categories": [          {            "id": "string",            "name": "string"          }        ],        "matched": true,        "clusterAnchorId": "string",        "clusterVenues": [          "string"        ]      },      "market": {        "id": "string",        "venueEventId": "string",        "venue": "string",        "externalIdentifier": "string",        "question": "string",        "shortTitle": "string",        "status": "string",        "startDate": "2019-08-24T14:15:22Z",        "endDate": "2019-08-24T14:15:22Z",        "createdAt": "2019-08-24T14:15:22Z",        "outcomes": [          {            "id": "string",            "label": "string",            "title": "string"          }        ],        "categories": [          {            "id": "string",            "name": "string"          }        ],        "matched": true,        "clusterAnchorId": "string",        "clusterVenues": [          "string"        ]      }    }  ],  "nextCursor": "string",  "hasMore": true}