Visionary API (0.1.6)
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.
- Credit Report: Reportes de crédito.
- CSF: Constancias de situación fiscal.
- INE Front: Parte frontal de la credencial de elector.
- INE Back: Parte trasera de la credencial de elector.
- CURP: Clave Única de Registro de Población.
- FM: Formato Migratorio 2 y 3.
- NSS: Documento y tarjeta de Seguro Social.
- PASSPORT: Pasaportes.
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) |
Responses
Response samples
- 200
- 422
- 500
{- "message": "Address proof OCR completed",
- "data": {
- "name": "Juan 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 |
Request Body schema: multipart/form-data
| file required | string <binary> (File) |
Password (string) or Password (null) (Password) |
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
}
}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) |
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) |
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) |
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"
}
]
}, - "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) |
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) |
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) |
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
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 |
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 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) |
Responses
Response samples
- 200
- 400
- 422
{- "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 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) |
Responses
Response samples
- 200
- 422
- 500
{- "message": "INE OCR completed",
- "data": {
- "name": "JUAN",
- "first_lastname": "PEREZ",
- "second_lastname": "GARCIA",
- "birthdate": "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
}
}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) |
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_check": "2",
- "nationality": "MEX",
- "emission_and_fuare": "123456789012345678",
- "name": "JUAN",
- "lastname": "PEREZ GARCIA"
}
}


