Retrieve integrity-checked retained evidence for an audited legal or retention purpose

GET/customers/{id}/records/{record}

Fresh dedicated customers:records:read staff authority and nonempty specific purpose required. Each successful retrieval is recorded immutably. Lists return at most 200 ordered IDs; pass the last ID as after. Customer and ingest-service identities cannot retrieve these legal records. Content retrieval verifies the retained hash and refuses disposed payloads; custody metadata remains available.

Path parameters

idstringRequired

recordstringRequired

Query parameters

purposestringOptional

Returns

200 OK

contentstring · byteRequired

recordobjectRequired

17 child attributes

active_holdsarray of stringsRequired

categorystringRequired

content_bytesintegerRequired

content_sha256stringRequired

content_typestringRequired

created_atstring · date-timeRequired

customer_idstringRequired

Example cust_2tVh8nqLxq4GbDe0K1F6S9zRcWm

disposed_atstring · date-time or nullOptional

idstringRequired

permanentbooleanRequired

recorded_atstring · date-timeRequired

recorded_bystringRequired

retain_untilstring · date-time or nullOptional

retention_starts_atstring · date-time or nullOptional

schedule_idstringRequired

source_refstringRequired

source_servicestringRequired

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503