Person Details

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

Gets the detailed breakdown of case files and lawsuits associated with a particular record (uuid).

---

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": "Detalle consultado correctamente",
  "data": {
    "source": {
      "uuid": "e9f54242-c097-4696-a28e-837f1c892304",
      "name": "AGUSTIN TORRES MUNGUIA",
      "count": 216
    },
    "records": [
      {
        "id": "0001",
        "judgement_type": "AMPARO",
        "plaintiff": "Daniel Castro",
        "defendant": "Juez de Control con Sede en Tijuana, Baja California",
        "state": "Nivel Federal",
        "type": "Procesos Civiles y Administrativos",
        "agreement_date": "2023-03-15",
        "file_number": "933/2022",
        "source": "Consejo de la Judicatura Federal",
        "court": "Juzgado Decimoseptimo De Distrito",
        "circuit": "DECIMO SEXTO CIRCUITO",
        "synthesis": "Se tiene por presentado el escrito...",
        "synthesis_url": "https://www.dgej.cjf.gob.mx/...",
        "source_url": "https://..."
      }
    ],
    "pagination": {
      "current_page": 1,
      "limit": 10,
      "total_records_found": 1,
      "total_pages": 1,
      "has_next": false,
      "has_previous": false
    },
    "categories": ["LABORAL", "PENAL"],
    "state": "CDMX",
    "consumption": {
      "consumption_type": "INCLUDED",
      "billable": false,
      "charged": true,
      "detail_status": "AVAILABLE",
      "unlocked_at": "2026-08-19T12:00:00.000Z"
    },
    "slow_response": false
  }
}