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 collected by running a BIL extraction. The extraction 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. Start a BIL extraction for the entity.
  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. For implementation details, see Extraction request examples.
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.
For endpoint details, see BIL Reports API Reference.