Search Person

Create Search

GET /risks/legal-records/searches/{searchId}/records/{uuid}/csv

Prerequisite:

The record (uuid) must have been previously unlocked through the details endpoint.

This endpoint does not apply additional charges.

Generates a signed link to download the detail information in CSV format.

---

Required Headers (HTTP Headers)

Header	Type	Required	Value / Example
Content-Type	string	Yes	application/json

Authentication

Authenticate with the method Blacktrust defined for your integration: the x-api-key header or Authorization: Bearer {accessToken} (one or the other, never both). See Authentication to find out which one applies to you.

---

Path

Name	Type	Required	Description
searchId	string	Yes	Unique search identifier generated by the search service.
uuid	string	Yes	Unique record identifier (records[].uuid).

---

Query Params

Name	Type	Required	Default	Description
limit	string	No	100	Total records per page
page	string	No	1	Page to retrieve
categories	string	No	—	List of categories. Comma-separated list: Amparo,Penal
states	string	No	—	List of states. Comma-separated list: CDMX,Durango
startDate	string	No	—	Start date (ISO 8601 format: YYYY-MM-DD).
endDate	string	No	—	End date (ISO 8601 format: YYYY-MM-DD).
role	string	No	—	Procedural role. Accepted values: Applicant, Defendant.

Billing Considerations

The first successful query for a specific uuid unlocks the detail and generates a charge. Subsequent queries or refinements on an already unlocked uuid will not generate charges again (consumption.charged: false).

---

API Responses

200 OK

{
  "isSuccess": true,
  "statusCode": 200,
  "message": "Enlace de descarga generado",
  "data": {
    "searchId": "9f0c3b52-2f8f-4a2f-9a0e-7b1a0c3d4e5f",
    "uuid": "e9f54242-c097-4696-a28e-837f1c892304",
    "download_url": "https://s3.amazonaws.com/export_e9f54242.csv?X-Amz-Signature=...",
    "expires_at": "2026-08-19T13:15:00.000Z",
    "file_name": "Registros_legales_20260819_120000.csv",
    "record_count": 216
  }
}