/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 | Parameter | Type | Description | |---|---|---| | `dataset_uuid` | string | The unique identifier of the dataset to query. | | `timestamp` | integer | Unix timestamp (seconds). Only records modified **after** this time are returned. | | `limit` | integer | Maximum number of records to return per page. | | `offset` | integer | Number 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:** | Field | Type | Description | |---|---|---| | `internal_id` | integer | Internal numeric identifier for the record. | | `unique_id` | string | Unique hexadecimal identifier for the record (use this with `/record/{record_uuid}` to fetch full content). | | `external_id` | string | Human-readable external identifier (e.g. `R040001`). | | `record_name` | string | Display name of the record, typically matches `external_id`. | **Example response:** ```json { "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