Skip to main content
GET
/
datasources
/
bil
/
reports
/
{id}
Retrieve a BIL report
curl --request GET \
  --url https://api.syntage.com/datasources/bil/reports/{id} \
  --header 'X-API-Key: <api-key>'
{
  "@id": "/datasources/bil/reports/9cc7fc78-5e84-4862-af83-c6c7022fcb41",
  "@type": "BilReport",
  "id": "9cc7fc78-5e84-4862-af83-c6c7022fcb41",
  "fecha": "2026-05-19T12:22:39-06:00",
  "investigado": "EMPRESA DE PRUEBA SA DE CV",
  "folio": "ENG10387-001",
  "gradoMaximo": 5,
  "data": {
    "REPORTES": {
      "REPORTE": {
        "TIPO": "BASICO",
        "INVESTIGADO": "EMPRESA DE PRUEBA SA DE CV",
        "FOLIO": "ENG10387-001",
        "GRADO_MAXIMO": "5"
      }
    }
  },
  "xmlFile": {
    "@id": "/files/88d3e2b7-6262-4ec7-9b2b-5a90a6227d01",
    "@type": "File",
    "id": "88d3e2b7-6262-4ec7-9b2b-5a90a6227d01",
    "type": "bil.report.xml",
    "resource": "/datasources/bil/reports/9cc7fc78-5e84-4862-af83-c6c7022fcb41",
    "mimeType": "text/xml",
    "extension": "xml",
    "filename": "ENG10387-001.xml"
  },
  "pdfFile": {
    "@id": "/files/0ab1bdf6-9008-4acf-8e31-8196405df2d0",
    "@type": "File",
    "id": "0ab1bdf6-9008-4acf-8e31-8196405df2d0",
    "type": "bil.report.pdf",
    "resource": "/datasources/bil/reports/9cc7fc78-5e84-4862-af83-c6c7022fcb41",
    "mimeType": "application/pdf",
    "extension": "pdf",
    "filename": "ENG10387-001.pdf"
  },
  "createdAt": "2020-01-01T12:15:00.000Z",
  "updatedAt": "2020-01-01T12:15:00.000Z"
}

Authorizations

​
X-API-Key
string
header
required

Your API key is available in the Production and Sandbox dashboards.

Path Parameters

​
id
string<uuid>
required

Response

BIL report resource response

Buró de Investigaciones Legales report generated for an entity.

​
@id
string<iri-reference>

BIL report IRI reference.

Example:

"/datasources/bil/reports/9cc7fc78-5e84-4862-af83-c6c7022fcb41"

​
@type
string
default:BilReport

JSON-LD resource type.

​
id
string<uuid>

Unique BIL report ID.

Example:

"9cc7fc78-5e84-4862-af83-c6c7022fcb41"

​
fecha
string<date-time>

Date and time reported by BIL for the generated report.

Example:

"2026-05-19T12:22:39-06:00"

​
investigado
string

Name searched and reported by BIL.

Example:

"EMPRESA DE PRUEBA SA DE CV"

​
folio
string

BIL report folio.

Example:

"ENG10387-001"

​
gradoMaximo
integer

Highest grade returned by BIL for the report.

Example:

5

​
data
object

Parsed BIL XML response. The structure follows the vendor response and can vary by report content.

Example:
{
  "REPORTES": {
    "REPORTE": {
      "TIPO": "BASICO",
      "INVESTIGADO": "EMPRESA DE PRUEBA SA DE CV",
      "FOLIO": "ENG10387-001",
      "GRADO_MAXIMO": "5"
    }
  }
}
​
xmlFile
object

File resource for the original BIL XML response.

Example:
{
  "@id": "/files/88d3e2b7-6262-4ec7-9b2b-5a90a6227d01",
  "@type": "File",
  "id": "88d3e2b7-6262-4ec7-9b2b-5a90a6227d01",
  "type": "bil.report.xml",
  "resource": "/datasources/bil/reports/9cc7fc78-5e84-4862-af83-c6c7022fcb41",
  "mimeType": "text/xml",
  "extension": "xml",
  "filename": "ENG10387-001.xml"
}
​
pdfFile
object

File resource for the BIL PDF report.

Example:
{
  "@id": "/files/0ab1bdf6-9008-4acf-8e31-8196405df2d0",
  "@type": "File",
  "id": "0ab1bdf6-9008-4acf-8e31-8196405df2d0",
  "type": "bil.report.pdf",
  "resource": "/datasources/bil/reports/9cc7fc78-5e84-4862-af83-c6c7022fcb41",
  "mimeType": "application/pdf",
  "extension": "pdf",
  "filename": "ENG10387-001.pdf"
}
​
createdAt
string

Date and time the resource was created

Example:

"2020-01-01T12:15:00.000Z"

​
updatedAt
string

Date and time the resource was last updated

Example:

"2020-01-01T12:15:00.000Z"