> ## Documentation Index
> Fetch the complete documentation index at: https://docs.syntage.com/llms.txt
> Use this file to discover all available pages before exploring further.

# BIL reports

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.

BIL is a premium datasource. Before the `bil` extractor can run via the API, your organization must have a signed agreement acknowledging responsibility for BIL charges, including charges caused by mistakes or duplicate requests.

Without that agreement, `POST /extractions` returns a validation error with the violation:

```json theme={null}
{
  "propertyPath": "extractor",
  "message": "This extractor does not support creating extractions via API."
}
```

If you see this error and the entity already has a name, contact your CSM or [Syntage Support](/using-syntage/faq/organization-billing-and-support#how-do-i-contact-support) to complete the BIL agreement before creating BIL extractions via API.

For implementation details, see [Extraction request examples](/developers/extraction-request-examples#bil).

| Field         | Description                                                                                        |
| ------------- | -------------------------------------------------------------------------------------------------- |
| `fecha`       | Date and time reported by BIL for the generated report.                                            |
| `investigado` | Name searched and reported by BIL.                                                                 |
| `folio`       | BIL report folio.                                                                                  |
| `gradoMaximo` | Highest grade returned by BIL for the report.                                                      |
| `data`        | Parsed BIL XML response. The structure follows the vendor response and can vary by report content. |
| `xmlFile`     | File resource for the original XML response.                                                       |
| `pdfFile`     | File resource for the BIL PDF report.                                                              |

For endpoint details, see [BIL Reports API Reference](/api-reference/ds-mx-bil-reports/retrieve-a-bil-report).