Visionary API (1.7.0)
Download OpenAPI specification:Download
Visionary es una API que permite a los usuarios enviar imágenes y obtener una descripción de las mismas usando modelos de lenguaje avanzados.
El objetivo de esta API, es permitir leer documentos no estructurados, como imágenes, y convertirlos en texto estructurado, para que puedan ser utilizados en otros sistemas.
- Address Proof: Documentos de identificación que contienen información de dirección.
- Bank Statement: Estados de cuenta bancarios.
- Carta Libranza: Cartas de libranza.
- CIF: Constancias de identificación fiscal.
- Constitutive Act: Actas constitutivas de empresas.
- Compliance Opinion: Opiniones de cumplimiento de obligaciones fiscales del SAT.
- Credit Contract: Contratos de crédito.
- Credit Report: Reportes de crédito.
- CSF: Constancias de situación fiscal.
- CURP: Clave Única de Registro de Población.
- FM: Formato Migratorio 2 y 3.
- Generic ID Front: Tarjetas de identificación oficiales.
- Generic ID Back: Tarjetas de identificación oficiales (parte trasera).
- Generic Extraction: Extracción de campos definidos por el usuario.
- INE Front: Parte frontal de la credencial de elector.
- INE Back: Parte trasera de la credencial de elector.
- ISN: Comprobantes estatales de línea de captura del Impuesto Sobre Nóminas.
- Lease Invoice: Facturas o CFDI de arrendamiento.
- NSS: Documento y tarjeta de Seguro Social.
- PASSPORT: Pasaportes.
- Payroll: Recibos de nómina.
- SUA: Cédulas y fichas de pago de obligaciones de seguridad social.
Esta API requiere un API key para ser utilizada. Pasa la API key en el header Rem-Apikey.
Para más información, visita la documentación.
Extract information from an address proof image
Endpoint to extract information from an address proof image
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Address proof OCR completed",
- "data": {
- "name": "Juan Perez",
- "name_components": {
- "first_name": "Juan",
- "first_last_name": "Perez"
}, - "type": "ELECTRICITY",
- "issued_by": "CFE",
- "date": "2023-01-01",
- "end_date": "2023-02-01",
- "likely_recent": true,
- "address": {
- "street": "Avenida Reforma",
- "ext_num": "1234",
- "int_num": "apt 123",
- "postal_code": "06000",
- "neighborhood": "Colonia Centro",
- "municipality": "Delegación Cuauhtémoc",
- "state": "Estado de México",
- "country": "México"
}
}
}Extract bank statement information from an image or PDF file.
Endpoint to extract information from a bank statement image
Authorizations:
query Parameters
| validate_rfc | boolean (Validate Rfc) Default: false |
| extended | boolean (Extended) Default: false When true and the uploaded file is a PDF, also extracts movements from all pages. |
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Bank statement information extracted",
- "data": {
- "name": "Juan Perez",
- "entity": "CFE",
- "rfc_person": "ABCD123456AB0",
- "rfc_person_structure_valid": true,
- "rfc_entity": "ABCD123456AB0",
- "rfc_entity_structure_valid": true,
- "date_start": "2023-01-01",
- "date_end": "2023-01-31",
- "account_number": "1234567890",
- "clabe": "123456789012345678",
- "average_amount": 1234.56,
- "total_amount": 12345.67,
- "total_income": 6789.01,
- "total_expenses": 5432.1,
- "type_of_account": "Debit",
- "movements": [ ]
}
}Extract information from a CURP image or PDF file
Endpoint to extract information from a CURP image
Authorizations:
query Parameters
| validate_curp | boolean (Validate Curp) Default: false |
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "CURP OCR completed",
- "data": {
- "full_name": "JUAN PEREZ HERNANDEZ",
- "curp": "PEHJ950101HDFRRL09",
- "curp_structure_valid": true,
- "birthdate": "1995-01-01",
- "state_of_birth": "DF",
- "state_of_registration": "Distrito Federal",
- "asociated_curps": [
- "PERJ900101HDFXXX01",
- "HUCA900101HDFXXX01"
], - "qr_found": true,
- "qr_valid": true,
- "curp_valid": true,
- "curp_response": {
- "curp": "PERJ900101HDFXXX01",
- "valid": true,
- "name": "JUAN",
- "first_last_name": "PÉREZ",
- "second_last_name": "GARCÍA",
- "birth_date": "1990-01-01",
- "gender": "H",
- "nationality": "MEX",
- "birth_federal_entity": "DF",
- "issuing_entity_key": "",
- "curp_status": "AN",
- "curp_status_description": "Alta Normal",
- "registration_year": "1990",
- "certificate_folio": "",
- "registration_entity_number": "01",
- "municipality_key": "001",
- "foreign_registration_number": "",
- "provatory_document": "Acta de Nacimiento",
- "probatory_document_data": {
- "id": "1",
- "name": "Acta de nacimiento",
- "book": "",
- "act_number": "000000",
- "sheet": "",
- "tome": "",
- "crip": "",
- "letter_folio": ""
}
}
}
}Extract information from a CIF image
Endpoint to extract information from a CIF image
Authorizations:
query Parameters
| validate_rfc | boolean (Validate Rfc) Default: false |
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "CIF OCR completed",
- "data": {
- "cif": {
- "full_name": "John Doe",
- "rfc": "ABCD123456EFG",
- "id": "1234567890"
}, - "identification_data": {
- "curp": "ABCD123456EFG",
- "name": "John",
- "first_lastname": "Doe",
- "second_lastname": "Smith",
- "birthdate": "2023-01-01",
- "start_date": "2023-01-01",
- "situation": "ACTIVO",
- "situation_last_update": "2023-01-01"
}, - "fiscal_address": {
- "street": "Av. Benito Juárez",
- "ext_num": "1000",
- "int_num": "Apto 123",
- "postal_code": "01000",
- "neighborhood": "Buena Vista",
- "municipality": "Venustiano Carranza",
- "state": "Ciudad de México",
- "email": "example@mail.com",
- "al": "CDMX1"
}, - "fiscal_characteristics": {
- "rfc": "ABCD123456EFG",
- "regimes": [
- {
- "regime": "Régimen de Sueldos y Salarios e Ingresos Asimilados a Salarios",
- "start_date": "2023-01-01"
}
]
}, - "qr_found": true,
- "qr_valid": true
}
}Extract information from a CSF image
Endpoint to extract information from a CSF image
Authorizations:
query Parameters
| validate_rfc | boolean (Validate Rfc) Default: false |
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "CSF OCR completed",
- "data": {
- "csf_data": {
- "full_name": "John Doe",
- "rfc": "ABCD123456EFG",
- "id": "1234567890"
}, - "identification_data": {
- "curp": "ABCD123456EFG",
- "name": "John",
- "first_lastname": "Doe",
- "second_lastname": "Smith",
- "birthdate": "2023-01-01",
- "start_date": "2023-01-01",
- "situation": "ACTIVO",
- "situation_last_update": "2023-01-01"
}, - "fiscal_address": {
- "street": "Av. Benito Juárez",
- "ext_num": "1000",
- "int_num": "Apto 123",
- "postal_code": "01000",
- "neighborhood": "Buena Vista",
- "municipality": "Venustiano Carranza",
- "state": "Ciudad de México",
- "email": "example@mail.com",
- "al": "CDMX1"
}, - "fiscal_characteristics": {
- "rfc": "ABCD123456EFG",
- "regimes": [
- {
- "regime": "Régimen de Sueldos y Salarios e Ingresos Asimilados a Salarios",
- "start_date": "2023-01-01"
}
]
}, - "economic_activities": [
- {
- "order": 1,
- "description": "Servicios de consultoría en computación",
- "percentage": 100,
- "start_date": "2017-04-24"
}
], - "qr_found": true,
- "qr_valid": true,
- "rfc_person_valid": true,
- "rfc_person_status": "Valid"
}
}Extract information from a NSS assignment document
Endpoint to extract information from a NSS assignment document
Authorizations:
query Parameters
| validate_curp | boolean (Validate Curp) Default: false |
| validate_nss | boolean (Validate Nss) Default: false |
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "NSS assignment OCR completed",
- "data": {
- "nss": "12345678901",
- "request_date": "2023-01-01",
- "folio": "1234567890",
- "name": "John Doe",
- "first_lastname": "Doe",
- "second_lastname": "Smith",
- "birthdate": "2023-01-01",
- "curp": "DOEJ850101HDFXXX01",
- "gender": "H",
- "state_of_birth": "Ciudad de México",
- "qr_found": true,
- "qr_valid": true,
- "nss_valid": true,
- "nss_structure_valid": true,
- "nss_response": {
- "success": true,
- "result": {
- "nss": "12345678901",
- "name": "John Doe",
- "first_lastname": "Doe",
- "second_lastname": "Smith",
- "birth_date": "2023-01-01"
}
}, - "curp_structure_valid": true,
- "valid_curp": true,
- "curp_response": {
- "curp": "PERJ900101HDFXXX01",
- "valid": true,
- "name": "JUAN",
- "first_last_name": "PÉREZ",
- "second_last_name": "GARCÍA",
- "birth_date": "1990-01-01",
- "gender": "H",
- "nationality": "MEX",
- "birth_federal_entity": "DF",
- "issuing_entity_key": "",
- "curp_status": "AN",
- "curp_status_description": "Alta Normal",
- "registration_year": "1990",
- "certificate_folio": "",
- "registration_entity_number": "01",
- "municipality_key": "001",
- "foreign_registration_number": "",
- "provatory_document": "Acta de Nacimiento",
- "probatory_document_data": {
- "id": "1",
- "name": "Acta de nacimiento",
- "book": "",
- "act_number": "000000",
- "sheet": "",
- "tome": "",
- "crip": "",
- "letter_folio": ""
}
}
}
}Extract information from a passport document
Extract the information from a passport document and return it in a structured format.
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Passport OCR completed",
- "data": {
- "type": "P",
- "number": "123456789",
- "nationality": "MEX",
- "expiration_date": "2023-12-31",
- "issuing_country": "MEX",
- "issuing_date": "2013-12-31",
- "birth_date": "1990-01-01",
- "birth_place": "MEX",
- "name": "Juan",
- "last_name": "Perez Garcia",
- "first_lastname": "Perez",
- "second_lastname": "Garcia",
- "gender": "M",
- "national_id": "123456789",
- "remarks": "Remarks"
}
}Extract information from a FM2 or FM3 document
Extract the information from a FM2 document and return it in a structured format.
Authorizations:
query Parameters
| validate_curp | boolean (Validate Curp) Default: false |
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "FM2 OCR completed",
- "data": {
- "type": "VISITANTE",
- "number": "0000000000001",
- "name": "JOHN DOE",
- "last_name": "DOE",
- "first_lastname": "DOE",
- "second_lastname": "SMITH",
- "country": "USA",
- "birth_date": "2000-01-01",
- "gender": "M",
- "curp": "ABCD900101HXXXXX00",
- "curp_structure_valid": true,
- "curp_valid": true,
- "expedition_date": "2022-01-01",
- "expiration_date": "2023-01-01",
- "curp_response": {
- "curp": "PERJ900101HDFXXX01",
- "valid": true,
- "name": "JUAN",
- "first_last_name": "PÉREZ",
- "second_last_name": "GARCÍA",
- "birth_date": "1990-01-01",
- "gender": "H",
- "nationality": "MEX",
- "birth_federal_entity": "DF",
- "issuing_entity_key": "",
- "curp_status": "AN",
- "curp_status_description": "Alta Normal",
- "registration_year": "1990",
- "certificate_folio": "",
- "registration_entity_number": "01",
- "municipality_key": "001",
- "foreign_registration_number": "",
- "provatory_document": "Acta de Nacimiento",
- "probatory_document_data": {
- "id": "1",
- "name": "Acta de nacimiento",
- "book": "",
- "act_number": "000000",
- "sheet": "",
- "tome": "",
- "crip": "",
- "letter_folio": ""
}
}
}
}Extract information from a carta libranza pdf
Endpoint to extract information from a carta libranza pdf, solo acepta archivos PDF.
- file: Carta libranza PDF file to be processed
- password: Password to unlock the PDF file (if needed)
- validate_curp: Validate the extracted CURP against the government database (default: False)
- pages: Number of pages to process (default: 1, max: 5)
- rem_apikey: API key to access the endpoint (passed in the header)
Authorizations:
query Parameters
| validate_curp | boolean (Validate Curp) Default: false |
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Pages (integer) or Pages (null) (Pages) Default: 1 | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Carta Libranza OCR completed successfully",
- "data": {
- "business_email": "test@mail.com",
- "business_name": "TEST COMPANY",
- "business_folio": "ABCD123456EFG",
- "business_phone": "5555555555",
- "curp": "XXXX900101XXXXXX00",
- "curp_structure_valid": true,
- "date": "2023-01-01",
- "email": "user@mail.com",
- "first_name": "John",
- "first_lastname": "Doe",
- "second_lastname": "Smith",
- "loan_amount": "$ 1,000.00",
- "loan_amount_to_receive": "$ 1,000.00",
- "loan_cat_with_iva": "0.00 %",
- "loan_first_deduction_date": "2023-01-01",
- "loan_folio_validity_date": "2023-01-01",
- "loan_monthly_deduction": "$ 1,000.00",
- "loan_term": "12 months",
- "loan_total_amount_due": "$ 1,000.00",
- "loans_to_liquidate": [
- {
- "cat_with_iva": "0.00 %",
- "loan_amount": "$ 1,000.00",
- "monthly_deduction": "$ 1,000.00",
- "deductions_term": "12 months",
- "capital_balance": "$ 1,000.00",
- "total_amount_due": "$ 1,000.00",
- "entity_clabe": "123456789012345678",
- "fine_entity": "TEST COMPANY"
}
], - "mobile_number": "5555555555",
- "nss": "12345678901",
- "ooad": "CDMX",
- "promotor": "John Doe"
}
}Extract data from a Mexican SAT compliance opinion PDF
Extracts the taxpayer name, opinion result, RFC, reference number, and issue date and time. This extraction does not verify the document's authenticity or query its current status with the SAT. The maximum PDF size is 20 MB.
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Compliance opinion information extracted",
- "data": {
- "taxpayer_name": "EMPRESA DE EJEMPLO SA DE CV",
- "opinion_result": "POSITIVA",
- "rfc": "ABC010203AB1",
- "reference_number": 123456789,
- "issued_at": "2026-09-17T10:35:42"
}
}Extract caller-defined string fields from a document
Accepts a PDF, JPEG, or PNG and a JSON string containing 1 to 50 field definitions. Each definition requires a lower-case snake_case name and a description of up to 150 characters. document_context is limited to 255 characters. PDFs are limited to six pages. All returned values are strings; missing values are empty strings.
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
| fields required | string (Fields) JSON string containing 1 to 50 objects with name and description properties |
| document_context required | string (Document Context) Description of the submitted document |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 400
- 422
- 503
{- "message": "Document information extracted",
- "data": {
- "taxpayer_name": "EMPRESA DE EJEMPLO SA DE CV",
- "reference_number": "000123456"
}
}Extract information from a credit report in PDF format
Authorizations:
Request Body schema: multipart/form-data
Password (string) or Password (null) (Password) | |
| file required | string <binary> (File) |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "status": "success",
- "message": "Credit report extracted successfully",
- "data": {
- "type": "PF_CDC",
- "name": "John Doe",
- "rfc": "ABCD123456EFG",
- "curp": "ABCD123456EFGHJKL01",
- "birthdate": "2022-01-01",
- "fiscal_address": {
- "street": "Calle 123",
- "number": "123",
- "neighborhood": "Colonia 123",
- "zip_code": "12345",
- "city": "Ciudad 123",
- "state": "Estado 123",
- "country": "País 123"
}, - "credit_score": 700,
- "shareholders": [
- {
- "name": "John Doe",
- "rfc": "ABCD123456EFG",
- "address": "Calle 123",
- "participation": "50%"
}
], - "guarantors": [
- {
- "name": "John Doe",
- "rfc": "ABCD123456EFG",
- "address": "Calle 123",
- "amount": 1000
}
], - "credits": [
- {
- "institution": "Bank",
- "current_balance": 1000,
- "overdue_balance": 100,
- "status": "CORRIENTE",
- "payment_amount": 100,
- "start_date": "2022-01-01",
- "end_date": "2022-12-31",
- "last_update": "2022-01-01",
- "last_payment_date": "2022-01-01",
- "credit_limit_amount": 1000,
- "max_credit_amount": 1000,
- "type": "COMERCIAL"
}
], - "previous_consultations": [
- {
- "institution": "Bank",
- "date": "2022-01-01",
- "phone": "1234567890",
- "address": "Calle 123, Ciudad 123, Estado 123, País 123"
}
]
}
}Extract credit contract information from an image or PDF file.
Endpoint to extract information from a credit contract image or PDF.
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Credit contract information extracted",
- "data": {
- "client_name": "Juan Perez Lopez",
- "condusef_number": "1234-5678-9012",
- "annual_interest_rate": 45,
- "default_interest_rate": 90
}
}Extract information from a INE front document
Extract the information from a INE front document and return it in a structured format.
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "INE OCR completed",
- "data": {
- "name": "JUAN",
- "last_name": "PEREZ",
- "mothers_last_name": "GARCIA",
- "birth_date": "1990-01-01",
- "gender": "H",
- "elector_key": "123456789012345678",
- "curp": "ABCD123456EFG",
- "expiration_date": "2030-01-01",
- "street": "DON CELES",
- "neighborhood": "CENTRO",
- "zip_code": "12345",
- "city": "CUAUHTEMOC",
- "province": "CDMX",
- "emission_number": "01",
- "type": "INE",
- "ine_type": "EFGH",
- "section_id": "0456",
- "register_year": "2023",
- "emission_year": "2023",
- "curp_verifier_digit_fixed": true,
- "is_foreign": false
}
}Extract information from INE reverse side document
Extract the information from a INE reverse side document.
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Ine reverse side extracted",
- "data": {
- "ocr_number": "123456789012345678",
- "lines": [
- "123456789012345678",
- "123456789012345678",
- "123456789012345678"
], - "cic": "123456789012345678",
- "cic_digit_check": "2",
- "is_cic_digit_check_consistent": true,
- "section_and_consecutive": "123456789012345678",
- "date": "20230101",
- "date_check_digit": "2",
- "gender": "H",
- "expiration_date": "20230101",
- "expiration_date_digit": "2",
- "nationality": "MEX",
- "emission_and_fuar": "123456789012345678",
- "name": "JUAN",
- "last_name": "PEREZ",
- "mother_last_name": "GARCIA",
- "last_names": "PEREZ GARCIA"
}
}Extract information from a INE front document
Extract the information from a INE front document and return it in a structured format.
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "INE OCR completed",
- "data": {
- "front": {
- "name": "JUAN",
- "first_lastname": "PEREZ",
- "second_lastname": "GARCIA",
- "birth_date": "1990-01-01",
- "gender": "H",
- "elector_key": "123456789012345678",
- "curp": "ABCD123456EFG",
- "expiration_date": "2030-01-01",
- "street": "DON CELES",
- "neighborhood": "CENTRO",
- "zip_code": "12345",
- "city": "CUAUHTEMOC",
- "province": "CDMX",
- "emission_number": "01",
- "type": "INE",
- "ine_type": "EFGH",
- "section_id": "0456",
- "register_year": "2023",
- "emission_year": "2023",
- "is_foreign": false
}, - "back": {
- "ocr_number": "123456789012345678",
- "lines": [
- "123456789012345678",
- "123456789012345678",
- "123456789012345678"
], - "cic": "123456789012345678",
- "cic_digit_check": "2",
- "is_cic_digit_check_consistent": true,
- "section_and_consecutive": "123456789012345678",
- "date": "20230101",
- "date_check_digit": "2",
- "gender": "H",
- "expiration_date": "20230101",
- "expiration_date_digit_check": "2",
- "nationality": "MEX",
- "emission_and_fuare": "123456789012345678",
- "name": "JUAN",
- "lastname": "PEREZ GARCIA"
}
}
}Extract data from a Mexican ISN declaration or payment document PDF
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "ISN payment information extracted",
- "data": {
- "state": "Jalisco",
- "issuing_authority": "Secretaría de la Hacienda Pública",
- "rfc": "ABC010203AB1",
- "declared_period": {
- "month": 6,
- "year": 2026,
- "raw": "Junio 2026"
}, - "issue_date": "2026-07-01",
- "due_date": "2026-07-17",
- "concepts": [
- {
- "code": "ISN",
- "description": "Impuesto Sobre Nóminas",
- "tax_base": 250000,
- "rate": 3,
- "amount": 7500
}
], - "withholding_concepts": [ ],
- "withholdings": 1250.5,
- "payment_reference": 1234567890,
- "total_amount": 10875.25
}
}Extract data from a Mexican lease invoice or CFDI PDF
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Success",
- "data": {
- "issuer": {
- "name": "string",
- "rfc": "string"
}, - "receiver": {
- "name": "string",
- "rfc": "string"
}, - "uuid": "string",
- "folio": "string",
- "issue_date": "2019-08-24T14:15:22Z",
- "certification_date": "2019-08-24T14:15:22Z",
- "due_date": "2019-08-24",
- "contract_number": "string",
- "asset": {
- "asset_type": "VEHICLE",
- "description": "string",
- "serial_number": "string",
- "vehicle_identification_number": "string",
- "license_plate": "string"
}, - "concepts": [
- {
- "product_service_code": "string",
- "identification_number": "string",
- "description": "string",
- "quantity": 0,
- "unit_code": "string",
- "unit_price": 0,
- "amount": 0
}
], - "installment_number": "string",
- "subtotal": 0,
- "vat_amount": 0,
- "total_amount": 0
}, - "error": "string",
- "error_type": "INVALID_REQUEST",
- "document_ownership": {
- "status": "evaluated",
- "relationship": "MATCH",
- "matches": [
- {
- "input_field": "ownership_full_name",
- "ocr_path": "string",
- "ocr_value": null,
- "match_type": "exact"
}
]
}
}Constitutive Act
Authorizations:
Request Body schema: application/x-www-form-urlencoded
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence | |
File (string) or File (null) (File) | |
Tmp File Id (string) or Tmp File Id (null) (Tmp File Id) |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Constitutive document extracted and analyzed",
- "data": {
- "company": {
- "legal_name": "GREYTECH SOLUCIONES",
- "legal_form": {
- "code": "CORPORATION",
- "raw": "SOCIEDAD ANÓNIMA DE CAPITAL VARIABLE (S.A. DE C.V.)"
}, - "jurisdiction": {
- "country": "MX",
- "subdivision": "CMX"
}, - "nationality": "MX",
- "incorporation_date": "2017-04-24",
- "duration": {
- "type": "INDEFINITE",
- "raw": "INDEFINIDA"
}, - "purpose": {
- "summary": "Desarrollo y comercialización de tecnología y software",
- "raw": "Texto completo del objeto social extraído..."
}, - "identifiers": [
- {
- "type": "TAX_ID",
- "value": "GSO170424PD2",
- "country": "MX"
}
], - "addresses": [
- {
- "type": "REGISTERED",
- "city": "Ciudad de México",
- "state": "Ciudad de México",
- "country": "MX",
- "full_address": "Domicilio social en Ciudad de México"
}
]
}, - "capital": {
- "currency": "MXN",
- "subscribed": 100000,
- "paid": 100000,
- "fixed": 20000,
- "total_shares": 100000,
- "share_classes": [
- {
- "code": "A",
- "type": "ORDINARY",
- "description": "Capital mínimo fijo",
- "nominal_value": 1,
- "voting_rights": "FULL"
}
]
}, - "parties": [
- {
- "id": "party-1",
- "party_type": "PERSON",
- "name": "ERICK IVÁN PÉREZ JIMÉNEZ",
- "nationality": "MX",
- "identifiers": [ ],
- "roles": [
- {
- "type": "SHAREHOLDER",
- "ownership": {
- "percentage": 51,
- "shares": 51000,
- "share_type": "ORDINARY",
- "control_type": "DIRECT",
- "is_beneficial_owner": true,
- "beneficial_owner_basis": "DIRECT_OWNERSHIP_GE_25_PERCENT"
}, - "powers": [ ]
}, - {
- "type": "DIRECTOR",
- "body_id": "body-1",
- "position": "PRESIDENT",
- "powers": [
- {
- "category": "GENERAL_ADMINISTRATION",
- "description": "Poder general para actos de administración"
}
]
}
]
}
], - "governance": {
- "management_model": "BOARD_OF_DIRECTORS",
- "bodies": [
- {
- "id": "body-1",
- "type": "BOARD_OF_DIRECTORS",
- "name": "CONSEJO DE ADMINISTRACIÓN",
- "member_ids": [
- "party-1"
]
}
]
}, - "registration": {
- "instruments": [
- {
- "type": "COMMERCIAL_POLICY",
- "number": "764",
- "date": "2017-04-24",
- "issuer": {
- "type": "PUBLIC_BROKER",
- "name": "Luis Roberto Lara Ramos",
- "number": "83",
- "country": "MX"
}
}
], - "registries": [
- {
- "name": "Registro Público de Comercio",
- "jurisdiction": {
- "country": "MX",
- "subdivision": "PUE"
}, - "registration_number": "N-2017037460",
- "folio": "N-2017037460"
}
]
}, - "findings": {
- "ownership": {
- "declared_percentage_total": 100,
- "declared_shares_total": 100000,
- "beneficial_owner_party_ids": [
- "party-1"
], - "controlling_party_ids": [
- "party-1"
], - "ownership_complete": true
}, - "warnings": [ ],
- "risk_flags": [
- {
- "code": "MAJORITY_SHAREHOLDER_CONTROL",
- "severity": "LOW",
- "party_ids": [
- "party-1"
], - "message": "Una persona posee más del 50% del capital social."
}
]
}, - "metadata": {
- "document_type": "CONSTITUTIVE_DOCUMENT",
- "document_country": "MX",
- "language": "es",
- "schema_version": "2.0",
- "confidence_score": 0.94
}
}
}Extract information from an official ID front document
Extract the information from an official ID front document and return it in a structured format.
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "ID OCR completed",
- "data": {
- "name": "JUAN",
- "first_lastname": "PEREZ",
- "second_lastname": "GARCIA",
- "birthdate": "1990-01-01",
- "gender": "H",
- "expiration_date": "2030-01-01",
- "national_id": "ABCD123456EFG",
- "street": "DON CELES",
- "neighborhood": "CENTRO",
- "zip_code": "12345",
- "city": "CUAUHTEMOC",
- "province": "CDMX",
- "country": "MEX",
- "emission_year": "2023",
- "document_type": "NATIONAL_ID"
}
}Extract information from an official ID back document
Extract the information from an official ID back document and return it in a structured format.
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "ID back OCR completed",
- "data": {
- "serial_number": "123456789012345678",
- "lines": [
- "ID12F5G1H3DF2<<<GH1DF",
- "513521351DFG<<FBDF",
- "JUAN<<PEREZ<<<<<<<<<<<"
], - "expiration_date": "2029-01-01",
- "country": "MEX",
- "extra_data": {
- "key": "value"
}, - "document_type": "NATIONAL_ID"
}
}Extract payroll information from an image or PDF file.
Endpoint to extract information from a payroll image
Authorizations:
query Parameters
| validate_rfc | boolean (Validate Rfc) Default: false |
| validate_curp | boolean (Validate Curp) Default: false |
| validate_cfdi | boolean (Validate Cfdi) Default: false |
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Payroll information extracted",
- "data": {
- "documentMetadata": {
- "documentType": "PAYROLL_SLIP",
- "sourceOrganization": "Empresa Ejemplo S.A. de C.V.",
- "uuid": "123e4567-e89b-12d3-a456-426614174000"
}, - "employer": {
- "name": "Empresa Ejemplo S.A. de C.V.",
- "rfc": "GODE561231GR8",
- "address": "Calle Principal 123, Ciudad de México"
}, - "employee": {
- "name": "Juan Pérez López",
- "rfc": "PELJ800101HDFRRN09",
- "curp": "PELJ800101HDFRRN09",
- "employeeId": "EMP12345",
- "socialSecurityNumber": "9988776655",
- "department": "Ventas",
- "jobTitle": "Representante de Ventas"
}, - "period": {
- "payFrequency": "Quincenal",
- "periodStartDate": "2023-08-01",
- "periodEndDate": "2023-08-15",
- "paymentDate": "2023-08-16",
- "daysPaid": 15,
- "daysWorked": 15
}, - "earnings": [
- {
- "code": "001",
- "description": "Sueldo",
- "amount": 7500
}, - {
- "code": "002",
- "description": "Horas Extras",
- "amount": 500
}
], - "deductions": [
- {
- "code": "001",
- "description": "ISR",
- "amount": 1200
}, - {
- "code": "002",
- "description": "IMSS",
- "amount": 400
}
], - "totals": {
- "gross": 8000,
- "deductions": 1600,
- "net": 6400
}, - "likely_recent": true,
- "rfc_person_structure_valid": true,
- "rfc_person_valid": true,
- "rfc_person_status": "Valid",
- "curp_valid": true,
- "curp_structure_valid": true,
- "curp_response": {
- "curp": "PERJ900101HDFXXX01",
- "valid": true,
- "name": "JUAN",
- "first_last_name": "PÉREZ",
- "second_last_name": "GARCÍA",
- "birth_date": "1990-01-01",
- "gender": "H",
- "nationality": "MEX",
- "birth_federal_entity": "DF",
- "issuing_entity_key": "",
- "curp_status": "AN",
- "curp_status_description": "Alta Normal",
- "registration_year": "1990",
- "certificate_folio": "",
- "registration_entity_number": "01",
- "municipality_key": "001",
- "foreign_registration_number": "",
- "provatory_document": "Acta de Nacimiento",
- "probatory_document_data": {
- "id": "1",
- "name": "Acta de nacimiento",
- "book": "",
- "act_number": "000000",
- "sheet": "",
- "tome": "",
- "crip": "",
- "letter_folio": ""
}
}, - "cfdi_valid": true,
- "cfdi_response": {
- "rfc_issuer": "ABCD910101XXX",
- "name_issuer": "EMPRESA EJEMPLO S.A. DE C.V.",
- "rfc_recipient": "PELJ800101AB7",
- "name_recipient": "JUAN PÉREZ LÓPEZ",
- "fiscal_invoice": "123e4567-e89b-12d3-a456-426614174000",
- "expedition_date": "2020-01-01T12:00:00",
- "certification_date": "2020-01-01T12:05:00",
- "pac": "ABC987654321",
- "amount": 10000,
- "voucher_effect": "Nómina",
- "cfdi_state": "Vigente",
- "cancelation_status": "Cancelable sin aceptación"
}, - "cfdi_checks": {
- "match_employee_rfc": true,
- "match_employer_rfc": true,
- "match_total_amount": true
}
}
}Extract data from a Mexican SUA payment form PDF
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) | |
Ownership Full Name (string) or Ownership Full Name (null) (Ownership Full Name) Person or institution name used to evaluate its relationship to the document | |
Ownership Curp (string) or Ownership Curp (null) (Ownership Curp) Optional CURP used as complementary ownership evidence | |
Ownership Rfc (string) or Ownership Rfc (null) (Ownership Rfc) Optional RFC used as complementary ownership evidence |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Success",
- "data": {
- "employer_registration": "string",
- "rfc": "string",
- "imss_payment_period": {
- "month": 1,
- "year": 2000,
- "raw": "string"
}, - "rcv_infonavit_payment_period": {
- "bimester": 1,
- "year": 2000,
- "raw": "string"
}, - "payment_due_date": "2019-08-24",
- "payment_reference": "string",
- "contribution_concepts": [
- {
- "code": "string",
- "description": "string",
- "employer_amount": 0,
- "employee_amount": 0,
- "total_amount": 0
}
], - "imss_fees": 0,
- "sar_contributions": 0,
- "severance_and_old_age_contributions": 0,
- "infonavit_contributions": 0,
- "infonavit_withholdings": 0,
- "total_amount": 0
}, - "error": "string",
- "error_type": "INVALID_REQUEST",
- "document_ownership": {
- "status": "evaluated",
- "relationship": "MATCH",
- "matches": [
- {
- "input_field": "ownership_full_name",
- "ocr_path": "string",
- "ocr_value": null,
- "match_type": "exact"
}
]
}
}Verify if a document is an original or a photocopy
Analyze an image to determine if it is an original identification document or a photocopy.
The analysis considers multiple factors including:
- Color quality (vibrant vs washed-out/grayscale)
- Edge definition (sharp vs blurred)
- Security features visibility
- Overall image quality and artifacts
Returns a detailed analysis with confidence score.
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Document analysis completed",
- "data": {
- "is_original": true,
- "confidence": 0.92,
- "is_color": true,
- "has_clear_edges": true,
- "has_vibrant_colors": true,
- "analysis_details": "The document shows vibrant colors with clear security features visible. The edges are sharp and well-defined. No signs of photocopying artifacts detected."
}
}Detect the document type from the first three PDF pages
Authorizations:
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) |
Responses
Response samples
- 200
- 422
- 503
{- "message": "Document classification completed",
- "data": {
- "document_type": "CREDIT_CONTRACT",
- "extraction_path": "/visionary/credit-contract",
- "pages_scanned": 3
}
}


