# Buró de Ingresos API Documentation

> Verifica los ingresos de tus usuarios con solo un CURP o RFC. Obtén información de ingresos y empleo directamente desde la fuente, en solo unos segundos

## Guides: Getting Started
- [Introduction](https://developers.burodeingresos.com/docs/introduction.md): Verify individual income and employment data, and retrieve business profile and invoice data using an 18-char CURP or a 12-char RFC.
- [Consents](https://developers.burodeingresos.com/docs/consents.md): Before retrieving information for an identifier, you must provide proof that the data owner authorized access to their information.
- [Verifications](https://developers.burodeingresos.com/docs/verifications.md): A Verification is the core resource of the Buró de Ingresos API. It represents a single async request to retrieve income and identity data for an `identifier`, whether that identifier is a CURP…
- [Sandbox](https://developers.burodeingresos.com/docs/sandbox.md): Test your integration using fictitious but valid-looking CURPs and RFCs.

## Guides: Integration
- [Authentication](https://developers.burodeingresos.com/docs/authentication.md): API key authentication, webhook signatures, IP allowlisting
- [API Response](https://developers.burodeingresos.com/docs/response.md): Interpret verification response fields, understand available data, and decide when to retry or fetch data endpoints.
- [Webhooks](https://developers.burodeingresos.com/docs/webhooks.md): Implement webhook notifications for verification updates, delivery retries, authentication, signature verification, and troubleshooting.
- [Bulks](https://developers.burodeingresos.com/docs/bulks.md): This page covers what a Bulk is, the lifecycle, how to inspect items, and the full `status_code` catalog.
- [Exports](https://developers.burodeingresos.com/docs/exports.md): Retrieve the results of a completed bulk as downloadable CSV files, notified by webhook.
- [Rate Limits](https://developers.burodeingresos.com/docs/rate-limits.md): Understand global and daily rate limits, response headers, and recommended retry practices.
- [Errors](https://developers.burodeingresos.com/docs/errors.md): Standard error response shape and the full list of error codes the Buró de Ingresos API can return.

## Guides: Data Reference
- [Profile](https://developers.burodeingresos.com/docs/profile.md): Reference for all fields returned by the Buró de Ingresos API when verifying an individual (persona física). Individuals are identified by an 18-character CURP.
- [Employment Status](https://developers.burodeingresos.com/docs/employment-status.md): How Buró de Ingresos determines the employment_status field: possible values, signal priority, and recency rules.
- [Invoices](https://developers.burodeingresos.com/docs/invoices.md): How to interpret invoice data returned by the API and compute income correctly from it.
- [Business Data](https://developers.burodeingresos.com/docs/business.md): Reference for all fields returned by the Buró de Ingresos API when verifying a business (persona moral). Businesses are identified by a 12-character RFC.
- [Estimates](https://developers.burodeingresos.com/docs/estimates.md): Monthly income, employment status and tenure computed with your own window, sources and date, plus a monthly history.

## API Reference: Buró de Ingresos API
- Verifications
  - [Create Verification](https://developers.burodeingresos.com/reference/createverification.md): Initiates a new verification process. Use an 18-char CURP for individuals or a 12-char RFC for businesses.
  - [Get Verification](https://developers.burodeingresos.com/reference/getverification.md): Retrieves the current status and detailed information of a specific verification.
  - [Delete Verification](https://developers.burodeingresos.com/reference/deleteverification.md): Deletes a specific verification by its ID.
  - [List Verifications](https://developers.burodeingresos.com/reference/listverifications.md): Retrieves a paginated list of verifications. Each item in the list provides a summarized view.
- Bulks
  - [Create Bulk Consents](https://developers.burodeingresos.com/reference/createbulkconsents.md): **Deprecated.** Send `ip_address` in `POST /verifications` instead (or in each item of `POST /verifications/bulk`). This endpoint keeps working until November 15, 2026, when it is removed.  Registers…
  - [Create Bulk Verifications](https://developers.burodeingresos.com/reference/createbulkverifications.md): Initiates a new bulk verification process for a list of identifiers. Each item must be an 18-char CURP (individual) or a 12-char RFC (business). Send `ip_address` in each item to record that item's…
  - [Get Bulk Status](https://developers.burodeingresos.com/reference/getbulk.md): Returns the status and metrics for a bulk job. Works for both consent and verification bulks. The `type` field tells you which kind of bulk this is.
  - [Delete Bulk](https://developers.burodeingresos.com/reference/deletebulk.md): Deletes a bulk job and all its associated items. Works for both consent and verification bulks. In-progress items are cancelled.
  - [List Bulk Items](https://developers.burodeingresos.com/reference/listbulkitems.md): Returns a paginated list of items inside a bulk. Use this endpoint to inspect which identifiers succeeded or failed, and why. Filter by `status` or `status_code` to drill into failures.
- Individual Information
  - [Get Profile](https://developers.burodeingresos.com/reference/getprofile.md): Retrieves profile information for an individual identified by an 18-char CURP. Includes `estimated_monthly_income`, an estimated net monthly income in MXN derived from the last 90 days of invoices…
  - [Get Invoices](https://developers.burodeingresos.com/reference/getindividualinvoices.md): Retrieves the invoices for an individual identified by an 18-char CURP. Requires a prior successful verification that yielded invoice data. Results can be paginated and filtered by invoice type and…
  - [Get Estimates](https://developers.burodeingresos.com/reference/getestimates.md): Computes `monthly_income`, `employment_status` and `tenure` for an individual identified by an 18-char CURP, with the settings you choose: how many months of history to use, which sources, and as of…
  - [Get Employments](https://developers.burodeingresos.com/reference/getemployments.md): Retrieves the employment history for an individual identified by an 18-char CURP. Requires a prior successful verification that yielded employment data. Results can be paginated and filtered by…
- Business Endpoints
  - [Get Business Profile](https://developers.burodeingresos.com/reference/getbusinessprofile.md): Retrieves business profile information for a business identified by a 12-char RFC. Returns the legal name, commercial name, and RFC of the business.
  - [Get Business Invoices](https://developers.burodeingresos.com/reference/getbusinessinvoices.md): Retrieves the invoices for a business identified by a 12-char RFC. Requires a prior successful verification that yielded invoice data. Results can be paginated and filtered by invoice type and issue…
- Webhooks
  - [Create Webhook](https://developers.burodeingresos.com/reference/createwebhook.md): Registers a new webhook URL to receive notifications for verification events. Users can optionally specify which events to subscribe to using the 'events' array. Supports `verification.completed`…
  - [List Webhooks](https://developers.burodeingresos.com/reference/getwebhooks.md): Retrieves a list of all registered webhooks.
  - [Update Webhook](https://developers.burodeingresos.com/reference/updatewebhook.md): Updates an existing webhook's configuration using the provided parameters. This operation allows changes to the webhook's URL, activation status, description, event subscriptions, and authentication…
  - [Get Webhook](https://developers.burodeingresos.com/reference/getwebhook.md): Retrieves a specific webhook by its ID.
  - [Delete Webhook](https://developers.burodeingresos.com/reference/deletewebhook.md): Deletes a specific webhook by its ID.
- Consents
  - [Create Consent](https://developers.burodeingresos.com/reference/createconsent.md): **Deprecated.** Send `ip_address` in `POST /verifications` instead (or in each item of `POST /verifications/bulk`). This endpoint keeps working until November 15, 2026, when it is removed.  Registers…
  - [List Consents](https://developers.burodeingresos.com/reference/listconsents.md): Retrieves a paginated list of consents, optionally filtered by identifier.
- Configuration
  - [Get Outbound IP Addresses](https://developers.burodeingresos.com/reference/getoutboundips.md): Retrieves the list of outbound IP addresses used by the API for external requests. This can be used to configure firewall rules or IP whitelisting.
- Exports
  - [Create Export](https://developers.burodeingresos.com/reference/createexport.md): Requests an asynchronous CSV export of a **completed** verification bulk. One file is generated per entity. The company is always taken from the API key, never from the request body.  Requests are…
  - [Get Export](https://developers.burodeingresos.com/reference/getexport.md): Returns the state of an export and, once completed, one signed download link per file.  Each `url` is valid for about **1 hour** and is re-issued fresh on every read, so if a link expires, call this…
- Monitoring
  - [Enroll Monitoring](https://developers.burodeingresos.com/reference/enrollmonitoring.md): Enrolls an identifier in monitoring for your company. Requires a valid consent for the identifier, unless you send `ip_address`: then a consent is recorded with that IP and your company's privacy…
  - [Get Monitoring](https://developers.burodeingresos.com/reference/getmonitoring.md): Returns the monitoring of an identifier for your company, in any status (`active`, `cancelled` or `expired`).
  - [Cancel Monitoring](https://developers.burodeingresos.com/reference/cancelmonitoring.md): Cancels the monitoring of an identifier: it is no longer verified each month. Idempotent: a monitoring that is not `active` is returned as it is. To resume it, enroll the identifier again.
  - [Enroll Bulk Monitoring](https://developers.burodeingresos.com/reference/enrollbulkmonitoring.md): Enrolls up to 10,000 identifiers in monitoring in one synchronous request, with the same rules as `POST /monitoring/{identifier}` (each identifier needs a valid consent; `ip_address` is not accepted…
  - [List Monitorings](https://developers.burodeingresos.com/reference/listmonitorings.md): Lists your company's monitorings with a given status (default `active`), ordered by identifier. Paginated by cursor: pass the `next_cursor` of the previous page as `cursor`. `next_cursor` is absent…

## Changelog
- [🔐 POST /consents retires November 15: send ip_address in POST /verifications](https://developers.burodeingresos.com/changelog/ip-based-consent-console-estimates-on-demand.md)
- [📊 New GET /estimates endpoint, more income estimates and webhook catch-up](https://developers.burodeingresos.com/changelog/get-estimates-more-income-estimates-webhook-catch-up.md)
- [📈 More coverage, bulk limits and export external IDs](https://developers.burodeingresos.com/changelog/more-coverage-bulk-limits-export-external-ids.md)
- [🔒 Safer invoice data and more reliable profile RFCs](https://developers.burodeingresos.com/changelog/safer-invoices-reliable-profile-rfc.md)
- [💳 Per-verification billing, webhook event selection and new invoice fields](https://developers.burodeingresos.com/changelog/per-verification-billing-webhook-events-payroll-bank.md)
- [📤 Async exports API and faster sandbox](https://developers.burodeingresos.com/changelog/exports-api-faster-sandbox.md)
- [📦 Export a bulk's data from the Console](https://developers.burodeingresos.com/changelog/console-export-by-bulk-id.md)
- [📂 Console exports and richer address ZIP codes](https://developers.burodeingresos.com/changelog/console-exports-richer-address-zip-codes.md)
- [📉 Net income estimates and no per-identifier daily limit](https://developers.burodeingresos.com/changelog/net-income-estimates-no-per-identifier-daily-limit.md)
- [🔑 API keys: one kind of key, multiple active, zero-downtime rotation](https://developers.burodeingresos.com/changelog/api-keys-multiple-active-keys-zero-downtime-rotation.md)