List records
const url = 'https://api.example.com/cms/data/matches/records?filter%5Bkickoff%5D=%7B%22gte%22%3A%222026-11-25%22%7D&filter%5Bhome%5D=21&sort=kickoff%2C-updatedAt&page_number=1&limit=20&include=home.country%2Caway&status=draft%2Cpublished';const options = {method: 'GET', headers: {'API-Key': '<API-Key>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://api.example.com/cms/data/matches/records?filter%5Bkickoff%5D=%7B%22gte%22%3A%222026-11-25%22%7D&filter%5Bhome%5D=21&sort=kickoff%2C-updatedAt&page_number=1&limit=20&include=home.country%2Caway&status=draft%2Cpublished' \ --header 'API-Key: <API-Key>'Filters work on the record’s id, externalId, createdAt, updatedAt and publishedAt, and on filterable fields: filter[field]=value (comma-separated: any of them) or filter[field][op]=value with op one of eq, neq, in, gt, gte, lt, lte, between (from,to), exists (1 or 0). Dates are ISO 8601; a date without a time is midnight UTC. Cached for the collection’s cache time; every write in the collection refreshes it.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Collection key
Example
matchesQuery Parameters
Section titled “Query Parameters”Filter[field]=value or filter[field][op]=value
object
Example
?filter[kickoff]=[object Object]&filter[home]=21Search in titles
Comma-separated; - for descending. id, title, createdAt, updatedAt, publishedAt or a single-value filterable field (3 fields at most). Default -updatedAt.
Example
kickoff,-updatedAt1–100
Reference fields to expand, comma-separated; a dot goes one level further (two at most)
Example
home.country,awayCMS users only: statuses to list, comma-separated (published when left out). Frontends always get published records.
Example
draft,publishedResponses
Section titled “Responses”Records
object
A record of a structured data collection
object
Record ID
The connector’s own id for the record, unique in the collection
The collection’s key
Status. Frontends (API keys not linked to a CMS user) only see published records.
The value of the collection’s title field
The field values, by field key. A reference holds the id of what it points to; expand it with include=.
object
With include=: what the named reference fields point to, by field key (an object, a list for several values, or null when it is missing or not published)
object
Created
Last changed
First published
Example
{ "data": [ { "id": 27, "externalId": "opta:m1", "collection": "matches", "status": "draft", "title": "Arsenal v Chelsea", "data": { "label": "Arsenal v Chelsea", "home": 21, "away": 22, "kickoff": "2026-11-20T20:00:00+00:00" } } ]}A filter, sort or include is not valid (the message says why)
No such collection or record