BUburodeingresos
Verifications

Create Verification

Changed on

Initiates a new verification process. Use an 18-char CURP for individuals or a 12-char RFC for businesses.

post/verifications

Request

Request body

identifierstring required

Identifier to verify. Use an 18-char CURP for individuals or a 12-char RFC for businesses.

external_idstring

Optional external identifier for tracking purposes. Can be used to correlate this verification with your internal systems.

rfcstring

Optional. If the user's RFC is provided, BDI uses it directly to retrieve invoice data, increasing the probability of recovering data for this individual.

phonestring required

Required for individuals using an 18-character CURP; not required for businesses using a 12-character RFC. Used for identity matching and to maximize the probability of recovering data. Must use E.164 format.

emailstring email

Optional. Used for identity matching and to maximize the probability of recovering data.

ip_addressstring

Optional. IP address of the end user when they accepted your privacy notice. When sent, the consent is recorded with this verification under your company's privacy notice, so no prior POST /consents is needed. A new consent is recorded on every request that sends it. Must be a valid IPv4 (e.g., 192.168.2.74) or IPv6 (e.g., 2001:db8::1) address.

Example request

{
  "identifier": "CUAI911021MOCRQS09",
  "external_id": "USER_67890_VERIFICATION_001",
  "rfc": "ABCD123456XYZ",
  "phone": "+525512345678",
  "email": "user@example.com",
  "ip_address": "201.141.22.10"
}

Response

Verification process initiated successfully. The process is asynchronous. A webhook will be sent upon completion. The response includes the verification ID and initial status, along with the consent_id that was automatically found.

idstring uuid

Unique identifier for the verification process.

identifierstring

The identifier for which the verification was initiated.

status'in_progress'

The initial status of the verification.

consent_idstring uuid

The ID of the consent that was found and used for this verification.

created_atstring date-time

Timestamp of when the verification was created.

external_idstring nullable

The external identifier provided in the request, if any.

Changes

  • 98eb3984cffbRevision changes
    • breaking

      the request property became required

    • info

      added the new optional request property

    • info

      added the non-success response with the status