Skip to main content
BIL reports come from Buró de Investigaciones Legales and summarize legal investigation results for an entity. Use them when your integration needs to review legal-risk findings, keep the original vendor report, or show the report PDF in your own product. BIL data is created by running the bil extractor. The extractor searches BIL using the entity’s name, stores the parsed report data, and attaches the original XML and PDF report files.

​
How BIL Reports Work

  1. Create an extraction with extractor set to bil.
  2. Poll the extraction until it reaches a terminal status.
  3. List the entity’s BIL reports.
  4. Retrieve the report by ID when you need the full report data or file references.
  5. Download the XML or PDF file through the Files API.

​
Requirements

The entity must have a name. BIL searches are name-based, so the extraction cannot run for an entity without a name.

​
Example Extraction Request

{
  "entity": "/entities/91106968-1abd-4d64-85c1-4e73d96fb997",
  "extractor": "bil"
}

​
Example Report

{
  "@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"
  }
}
FieldDescription
fechaDate and time reported by BIL for the generated report.
investigadoName searched and reported by BIL.
folioBIL report folio.
gradoMaximoHighest grade returned by BIL for the report.
dataParsed BIL XML response. The structure follows the vendor response and can vary by report content.
xmlFileFile resource for the original XML response.
pdfFileFile resource for the BIL PDF report.