Skip to navigation

/dataset/{datset_uuid}/modified/records/{timestamp}/{limit}/{offset}

View as Markdown

Returns a paginated list of records within a dataset that have been modified since a given Unix timestamp. This endpoint is intended for incremental sync use cases — it does not return full record content, only lightweight identifiers sufficient to detect which records have changed and need to be fetched in full via /record/{record_uuid}.

Path Parameters

ParameterTypeDescription
dataset_uuidstringThe unique identifier of the dataset to query.
timestampintegerUnix timestamp (seconds). Only records modified after this time are returned.
limitintegerMaximum number of records to return per page.
offsetintegerNumber of records to skip, used for pagination.

Authentication

Requires a Bearer token in the Authorization header. The pre-request script automatically obtains a fresh token using the apiuser and apipass environment variables.

Response

Returns a 200 OK with a JSON object containing a records array. Each item in the array is a lightweight record summary — not the full record content.

Response fields per record:

FieldTypeDescription
internal_idintegerInternal numeric identifier for the record.
unique_idstringUnique hexadecimal identifier for the record (use this with /record/{record_uuid} to fetch full content).
external_idstringHuman-readable external identifier (e.g. R040001).
record_namestringDisplay name of the record, typically matches external_id.

Example response:

{
"records": [
{
"internal_id": 640190,
"unique_id": "134d21e4ce17bbee7203b6e6a8a4",
"external_id": "R040001",
"record_name": "R040001"
},
{
"internal_id": 640191,
"unique_id": "8bcbd262fdc6bc5f7582ccd937ee",
"external_id": "R040002",
"record_name": "R040002"
}
]
}

Pagination

Use limit and offset together to page through large result sets. For example, to retrieve the second page of 20 results, set limit=20 and offset=20.

Usage Pattern

This endpoint is typically used as the first step in a two-phase sync:

  1. Call this endpoint with the timestamp of your last sync to get the list of modified record identifiers.
  2. For each unique_id returned, call /record/{record_uuid} to retrieve the full record content.

Response headers

Access-Control-Allow-OriginstringOptional
Access-Control-Allow-MethodsstringOptional
Access-Control-Allow-HeadersstringOptional
Access-Control-Expose-HeadersstringOptional
Access-Control-Max-AgestringOptional
Cache-ControlstringOptional
X-Debug-TokenstringOptional
Keep-AlivestringOptional

Response

OK
recordslist of objects