Buscar Persona
Crear Búsqueda
GET
/risks/legal-records/searches/{searchId}/records/{uuid}/csv
Requisito previo:
El registro (uuid) debe haber sido desbloqueado previamente mediante el de detalles.
Este endpoint no aplica cobros adicionales.
Genera un enlace firmado para la descarga en formato CSV de la información del detalle.
Encabezados Requeridos (HTTP Headers)
| Header | Tipo | Requerido | Valor / Ejemplo |
|---|---|---|---|
Content-Type | string | Sí | application/json |
Autenticación
Autentícate con el método que Blacktrust definió para tu integración: el header x-api-key o Authorization: Bearer {accessToken} (uno u otro, nunca ambos). Consulta Autenticación para saber cuál aplica en tu caso.
Path
| Nombre | Tipo | Requerido | Descripción |
|---|---|---|---|
searchId | string | Si | Identificador único de la búsqueda generado en el servicio de búsqueda. |
uuid | string | Si | Identificador único del registro (records[].uuid). |
Query Params
| Nombre | Tipo | Requerido | Default | Descripción |
|---|---|---|---|---|
limit | string | No | 100 | El total de registros por página |
page | string | No | 1 | Página a consultar |
categories | string | No | — | Lista de categorías. Lista separada por comas: Amparo,Penal |
states | string | No | — | Lista de estados. Lista separada por comas: CDMX,Durango |
startDate | string | No | — | Fecha desde (Formato ISO 8601: YYYY-MM-DD). |
endDate | string | No | — | Fecha hasta (Formato ISO 8601: YYYY-MM-DD). |
role | string | No | — | Rol procesal. Valores aceptados: Applicant, Defendant. |
Consideraciones de Facturación
La primera consulta exitosa a un uuid específico desbloquea el detalle y genera un consumo. Las consultas o refinamientos posteriores sobre un uuid ya desbloqueado no volverán a generar cobros (consumption.charged: false).
Respuestas de la API
- 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
}
}