Skip to navigation

/dataset/record/{record_uuid}

View as Markdown

Retrieves a single dataset record by its UUID.

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

ParameterTypeRequiredDescription
record_uuidstringYesThe UUID of the record to retrieve (e.g. c00710bb4560d99280ee6b86a5fd)

Headers

KeyValue
Content-Typeapplication/json

Example Response (200 OK)

{
"database_uuid": "ddc5e9ba834ad596cc31aebb1225",
"internal_id": 781070,
"record_name": "R260016",
"record_uuid": "c00710bb4560d99280ee6b86a5fd",
"template_uuid": "60231f230a3c7b73e0f0d1f1deea",
"metadata_for_uuid": "",
"_record_metadata": {
"_create_date": "2026-04-04 00:48:02",
"_update_date": "2026-04-04 00:50:50",
"_create_auth": "Hexiong Yang",
"_public_date": "2026-04-04 00:48:02"
},
"fields": [
{
"field_name": "Sample ID",
"field_uuid": "b5973a5ac47ec4afd1db49e2b00f",
"template_field_uuid": "3e2259d0039f2c5cc912b8f92681",
"id": 7068,
"value": 11429
},
{
"field_name": "RRUFF ID",
"field_uuid": "ee88404d73886150b59dd07cbb12",
"template_field_uuid": "d0e7a8e1e42d8159008116130e86",
"id": 7069,
"value": "R260016"
},
{
"field_name": "Sample Status",
"field_uuid": "e4bd3c7024d12f5c80da99fffd63",
"template_field_uuid": "040f8debf923926eef9b426521ad",
"id": 7070,
"values": [
{
"id": 7793,
"template_radio_option_uuid": "6b40829ca6e77002513def5f7406",
"name": "The identification of this mineral is not yet confirmed",
"selected": 1
}
]
},
{
"field_name": "Sample Source",
"field_uuid": "56b4777019c9a0f4e692586f0d87",
"id": 7071,
"value": "RRUFF"
},
{
"field_name": "Sample Owned by",
"field_uuid": "e2b22fc6abedceff7684aa6005ce",
"id": 7073,
"value": "RRUFF"
},
{
"field_name": "Sample Description",
"field_uuid": "e742f7288df2b103b29ebab58faa",
"id": 7074,
"value": "Colorless bladed crystals. A new mineral with the composition K2(Mo2O7)(H2O)."
},
{
"field_name": "Sample Locality",
"field_uuid": "9ad6f78291e867858e8c84b6fba4",
"id": 7075,
"value": "Freedom No. 2 mine, Marysvale District, Piute County, Utah, USA"
}
],
"records": []
}

Response Fields

FieldTypeDescription
database_uuidstringUUID of the parent database
internal_idintegerInternal numeric identifier for the record
record_namestringHuman-readable name of the record
record_uuidstringUnique identifier for this record
template_uuidstringUUID of the template this record is based on
metadata_for_uuidstringUUID of the record this record provides metadata for (empty if not applicable)
_record_metadataobjectAudit metadata including create/update dates and author
fieldsarrayList of field objects containing the record’s data values
recordsarrayList of child records associated with this record

Each object in fields contains:

FieldTypeDescription
field_namestringHuman-readable name of the field
field_uuidstringUnique identifier for this field instance
template_field_uuidstringUUID of the template field definition
idintegerInternal numeric ID of the field
valuestring | numberThe field’s scalar value (present for text/number fields)
valuesarrayThe field’s selected option(s) (present for radio/select fields)
_field_metadataobjectAudit metadata for the field

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
database_uuidstring
internal_idinteger
record_namestring
record_uuidstring
template_uuidstring
metadata_for_uuidstring
_record_metadataobject
fieldslist of objects
recordslist of any