Verification

Field Name	Type	Description	Example	Notes
`id`	`string (UUID)`	Unique verification identifier	`"bd830637-ea6e-4888-80ab-a09f01fc9209"`	Auto-generated
`identifier`	`string`	Primary key - CURP or RFC	`"OICE940722HGFRST08"`	18 chars for CURP, 12-13 chars for RFC
`status`	`string`	Verification status	`"completed"`	`"in_progress"` or `"completed"`
`data_available`	`boolean`	If any data was found using this Identifier	`True`	`True` or `False`
`can_retry`	`boolean`	If the verification can be retried	`False`	`True` or `False`
`entities`	`array`	Type of Data Available	`["profile", ,"employment","employment_files" "invoices"]`
`consent_id`	`string (UUID)`	Consent reference	`"92d78902-61e0-4fc1-93e6-243519259cb3"`	Required for any verification

Profile

Personal Info

Field Name	Type	Description	Example	Notes
`first_name`	`string`	First Name	`"María Jose"`
`last_name`	`string`	Last Name	`"Pérez Estrada"`
`curp`	`string`	Individual's CURP	`MAPE850312HDFRRR02`
`nss`	`string`	Social Security Number	`65189234567`	May be null
`rfc`	`string`	Tax ID number	`MAPE850312F23`
`phone`	`string`	Contact phone	`525540235678`	May be null
`email`	`string`	Contact email	`"[email protected]"`	May be null

Address

Field Name	Type	Description	Example	Notes
`street`	`string`	Street address	`"Valle del Olmo 28"`	Address component
`neighborhood`	`string`	Neighborhood	`"Nueva Santa María"`	Address component
`municipality`	`string`	Municipality	`"Azcapotzalco"`	Address component
`state`	`string`	State/entity	`"CDMX"`	Address component
`zip_code`	`string`	Postal code	`"52340"`	Address component

Employment Status

We determine an individual’s employment status based on their Employment and Invoice records.

The possible values are: employed, self_employed, unemployed or unknown

Employment Files

Official employment documentation files from IMSS and ISSSTE. These are downloadable PDF documents that provide verifiable proof of employment records and contribution history.

Field Name	Type	Description	Example	Notes
`identifier`	`string`	CURP or RFC associated with the files	`"MAPE850312HDFRRR02"`	Same as verification identifier
`employment_files`	`array[object]`	Array of employment document files	See below	May be empty if no files available

Employment File Object

Each item in the employment_files array contains:

Field Name	Type	Description	Example	Notes
`url`	`string` (URL)	Pre-signed download URL	`"https://storage.googleapis.com/...?X-Amz-..."`	Temporary URL, expires after 15 minutes
`name`	`string`	Document name	`"Constancia de Semanas Cotizadas en el IMSS"`	Human-readable document description
`institution`	`string`	Source institution	`"imss"` or `"issste"`	Government agency that issued document
`uploaded_at`	`string` (ISO 8601)	When the file was uploaded/generated	`"2025-10-02T01:23:41Z"`	Full timestamp in UTC

Document Types by Institution

Institution	Document Name	Description
`imss`	Constancia de Semanas Cotizadas en el IMSS	Shows entire employment history as reported to IMSS
`imss`	Reporte de Cotización al IMSS	Shows current employment status and salary as reported to IMSS.
`imss`	Constancia de No Derechohabiente	Certificate attesting that the user is not registered in IMSS.
`issste`	Expediente Electrónico Único del ISSSTE	Unique electronic file from ISSSTE

Important Notes

The url field contains a pre-signed URL that expires after 15 minutes (X-Amz-Expires=900)
Files are in PDF format
Each verification may return multiple files depending on which institutions have data for the identifier
If no employment files are available, the employment_files array will be empty: []

Employment

These fields are exclusively obtained from IMSS and/or ISSSTE.

Field Name	Type	Description	Example	Notes
`semanas_cotizadas`	`number`	Number of weeks been paid into IMSS	447	This could be used as a proxy indicator of how long a worker has been in formal employment.
`employer`	`string`	Company name	`"CONSTRUCCIONES YAMILE"`
`employer_registration`	`string`	Company registration	`"Y606341210"`
`start_date`	`string`(date)	Employment start	`"2020-02-22"`	YYYY-MM-DD format
`end_date`	`string` (date)	Employment end	`"2020-02-15"`	Null = current job
`federal_entity`	`string`	Work location	`"CIUDAD DE MÉXICO"`	State/region
`base_salary`	`number`	Daily salary	`116.02`	in MXN
`monthly_salary`	`number`	Monthly salary	`3529.33`	in MXN
`pdf_link`	`string` (URL)	Document link	`"https://link_to_pdf.com"`	May be null

Earnings

Platform economy income data from ride-sharing and delivery services. These fields provide monthly earnings history from connected platforms.

Field Name	Type	Description	Example	Notes
`identifier`	`string`	CURP or RFC associated with earnings	`"CURP123456HDFLRS09"`	Same as verification identifier
`updated_at`	`string` (ISO 8601)	When earnings data was last updated	`"2025-11-06T22:04:24.174750Z"`	Full timestamp in UTC
`earnings_history`	`array[object]`	Array of monthly earnings records	See below	Sorted by period (most recent first)
`pagination`	`object`	Pagination information	See Pagination section	Standard pagination object

Earnings Period Object

Each item in the earnings_history array contains:

Field Name	Type	Description	Example	Notes
`period`	`string`	Month and year of earnings	`"2025-03"`	YYYY-MM format
`amount`	`number`	Total earnings for the period	`21000.00`	Decimal format
`currency`	`string`	Currency code	`"MXN"`	Usually MXN
`platform`	`string`	Platform where earnings were generated	`"uber"`	e.g., uber, didi

Example Earnings History

Period	Amount	Currency	Platform
2025-03	21,000.00	MXN	uber
2025-02	18,500.75	MXN	uber
2025-01	15,000.50	MXN	uber

Important Notes

Earnings data is aggregated by month (period in YYYY-MM format)
Each platform reports separately (e.g., Uber and Didi earnings appear as separate records)
Historical data availability varies by platform and user
This data complements traditional employment records by capturing gig economy income

Invoice

Field Name	Type	Description	Example	Notes
`type`	`string`	Invoice type	`"nomina"`	See Invoices Types
`amount`	`number`	Total amount	`42487.53`
`currency`	`string`	Currency code	`"mxn"`	Usually MXN
`folio_fiscal`	`string`	Fiscal identifier of invoice	`"7A9F33E4-892C-4B8D-A9E1-2F6F0001"`	May be null
`issue_date`	`string` (ISO 8601)	Official issue time	`"2025-04-01T10:00:00Z"`	Full timestamp
`rfc_issuer`	`string`	Issuer's RFC	`"CYA010101AAA"`	Who issued the invoice
`issuer_name`	`string`	Issuer's name	`"Construcciones Yamile S.A. de C.V."`	Name of individual or company issuing the invoice
`rfc_receiver`	`string`	Receiver's RFC	`"OICE940722GHW"`	Who received the invoice
`receiver_name`	`string`	Receiver's name	`"José Carlos Aguilar Rincón"`	Name of individual or company receiving the invoice

Incomes and Deductions

Field Name	Type	Description	Example	Notes
`incomes`	`array[object]`	Income breakdown	`[{"amount": 35000, "currency": "MXN", "detail": "base salary"}]`	Array of income items
`deductions`	`array[object]`	Deduction breakdown	`[{"amount": 5832.23, "currency": "MXN", "detail": "IMSS"}]`	Array of deduction items

Keep in mind that the detail field can contain any value — it is not limited to a fixed list. This is an example:

Category	Detail	Currency	Amount
`incomes`	`RAYA ORDINARIA 6 DIA`	`MXN`	`1,943.40`
`incomes`	`SEPTIMO DIA`	`MXN`	`323.9`
`deductions`	`IMSS`	`MXN`	`69.33`
`deductions`	`ISR`	`MXN`	`188.47`

Invoice Types

Below is a reference table for the invoice types supported by the SAT and returned by the API:

Code	Meaning	Type	Description	Currently Available
`nomina`	Nómina	Payroll	Payroll receipts issued to employees	Yes
`ingreso`	Ingreso	Income	Invoice for sales of goods or services	Yes
`egreso`	Egreso	Credit Note	Issued for returns, discounts, or invoice corrections	Yes
`traslado`	Traslado	Transfer	Transfer of goods without sale (internal movements)	No
`pago`	Pago	Payment	Payment complement for previously issued invoices	No