/dataset/{dataset_uuid}/{limit}/{offset}

Retrieves a paginated list of records from a dataset. **Authentication** This request uses a pre-request script to automatically obtain a bearer token from `{{url}}/token` using the `{{apiuser}}` and `{{apipass}}` environment variables. The token is stored in `{{token}}` and used for authorization. **Path Parameters** | Parameter | Type | Required | Description | | --- | --- | --- | --- | | `dataset_uuid` | string | Yes | The UUID of the dataset to retrieve records from (e.g. `ddc5e9ba834ad596cc31aebb1225`) | | `limit` | integer | No | Maximum number of records to return. Defaults to 100 if not specified | | `offset` | integer | No | Zero-based offset for pagination. Use with `limit` to page through results | **Example Request** ``` GET {{url}}/dataset/ddc5e9ba834ad596cc31aebb1225/3/0 ``` Retrieves the first 3 records from dataset `ddc5e9ba834ad596cc31aebb1225`. **Example Response (200 OK)** ``` json { "count": 3, "records": [ { "database_uuid": "ddc5e9ba834ad596cc31aebb1225", "internal_id": 640186, "record_name": "R040003", "record_uuid": "c67a06e7b4a6c8d7d11bab1588ce", "template_uuid": "60231f230a3c7b73e0f0d1f1deea", "metadata_for_uuid": "", "_record_metadata": { "_create_date": "2004-12-01 00:00:00", "_update_date": "2026-03-19 17:57:59", "_create_auth": "rruff@rruff.info", "_public_date": "2005-05-25 00:00:00" }, "fields": [ { "field_name": "Sample ID", "field_uuid": "b5973a5ac47ec4afd1db49e2b00f", "template_field_uuid": "3e2259d0039f2c5cc912b8f92681", "id": 7068, "value": 1 }, { "field_name": "RRUFF ID", "field_uuid": "ee88404d73886150b59dd07cbb12", "template_field_uuid": "d0e7a8e1e42d8159008116130e86", "id": 7069, "value": "R040003" } ], "records": [] } ] } ``` **Response Fields** | Field | Type | Description | | --- | --- | --- | | `count` | integer | Total number of records returned in this response | | `records` | array | List of record objects | Each object in `records` contains: | Field | Type | Description | | --- | --- | --- | | `database_uuid` | string | UUID of the parent database | | `internal_id` | integer | Internal numeric identifier for the record | | `record_name` | string | Human-readable name of the record | | `record_uuid` | string | Unique identifier for this record | | `template_uuid` | string | UUID of the template this record is based on | | `metadata_for_uuid` | string | UUID of the record this record provides metadata for (empty if not applicable) | | `_record_metadata` | object | Audit metadata including create/update dates and author | | `fields` | array | List of field objects containing the record's data values | | `records` | array | List of child records associated with this record | Each object in `fields` contains: | Field | Type | Description | | --- | --- | --- | | `field_name` | string | Human-readable name of the field | | `field_uuid` | string | Unique identifier for this field instance | | `template_field_uuid` | string | UUID of the template field definition | | `id` | integer | Internal numeric ID of the field | | `value` | string | number | The field's scalar value (present for text/number fields) | | `values` | array | The field's selected option(s) (present for radio/select fields) | | `_field_metadata` | object | Audit metadata for the field |