v1

latestOpenAPI 3.1.0Apache 2.02026-07-24113269342.0 KB
Id capture

Fetch ocr data

Returns data about user read from id and address statement.

get/omni/get/ocr-data

Query parameters

idstring

Id of onboarding for which data are requested. If not present, it will be extracted from token.

Headers

api-versionstring required

Response

OK

addressstring

Address as read from id. Address can have two or three lines. Lines are separated by \n

fullAddressboolean

This field is set to true if address from id is full (has three lines) or not (For Mexican Voter IDs only).

invalidAddressboolean

This field checks for a valid street, numeric postal code with 5 digits, and that both colony and city have values. (Only checked for Mexican IDs)

checkedAddressstring

Address as obtained after processing with geocoder geolocation api.

exteriorNumberstring

Exterior street number.

interiorNumberstring

Interior street number.

addressFromStatementstring

Address as read from address statement. Lines are separated by \n.

invalidAddressFromStatementboolean

This field checks for a valid street, numeric postal code with 5 digits, and tha both colony and city have values. (Only checked for Mexican POA)

addressStatementEmissionDateinteger

Issue date of address statement. The value is presented in UTC milliseconds.

documentType'a1' | 'aggm' | 'apg' | 'energieAg' | 'cre' | 'aforeAzteca' | 'amd' | 'amicsa' | 'att' | 'axtel' | 'bancoppel' | 'bancoAzteca' | 'banorte' | 'bbva' | 'cab' | 'caev' | 'capa' | 'cea' | 'cfe' | 'citibanamex' | 'cmapa' | 'cmapaGrande' | 'cmapas' | 'cmas' | 'cmasBlue' | 'comapa' | 'comapaRed' | 'coppel' | 'dapa' | 'dhc' | 'drenaje' | 'ecogas' | 'engie' | 'gasNatural' | 'h' | 'hsbc' | 'inbursa' | 'infonavit' | 'interapas' | 'isagas' | 'izzi' | 'jad' | 'japam' | 'japama' | 'japami' | 'japay' | 'jiapaz' | 'jmas' | 'jras' | 'jumapac' | 'jumapam' | 'lerdo' | 'liverpool' | 'mas' | 'megacable' | 'naturgy' | 'oapas' | 'odapas' | 'ooapas' | 'opdm' | 'oroapa' | 'sacmex' | 'sacmexCdmx' | 'santander' | 'sapa' | 'sapal' | 'sapamuy' | 'sapasa' | 'sapasma' | 'scotiabank' | 'seapal' | 'siapa' | 'simapag' | 'simapas' | 'simas' | 'smapa' | 'smapac' | 'smapam' | 'smapas' | 'spectrum' | 'stori' | 'sura' | 'tam' | 'telcel' | 'telmex' | 'totalplay' | 'veolia' | 'victoria' | 'wizz' | 'asylumSeeker' | 'refugeeId' | 'refugeeStatus' | 'ute' | 'telkom' | 'tmobile' | 'verizon' | 'xfinity' | 'aforeCoppel' | 'americanExpress' | 'ap' | 'telnor' | 'wellsFargo' | 'otherPoa'

Type of address statement document. Possible values:

  • Mexico: liverpool, citibanamex, cfe, telcel, izzi, axtel, telmex, oapas, sacmex, opdm, naturgy, drenaje, totalplay, dhc, att, cea, smapa, megacable, jmas, amicsa, caev
  • Bolivia: cre
  • Uruguay: ute
  • Unknown document: otherPoa
poaNamestring

Extracted name from address statement.

typeOfId'Unknown' | 'Passport' | 'Visa' | 'DriversLicense' | 'IdentificationCard' | 'Permit' | 'Currency' | 'ResidenceDocument' | 'TravelDocument' | 'BirthCertificate' | 'VehicleRegistration' | 'Other' | 'WeaponLicense' | 'TribalIdentification' | 'VoterIdentification' | 'Military' | 'TaxIdentification' | 'FederalID' | 'MedicalCard'
documentFrontSubtypestring

Additional info about ID type (front side)

documentBackSubtypestring

Additional info about ID type (back side)

issueFrontinteger

Issue year (per classification model) of the ID (front side)

issueBackinteger

Issue year (per classification model) of the ID (back side)

birthDateinteger

Date of birth is presented in UTC milliseconds.

gender'M' | 'F' | 'X'

Gender values are presented in English. "M" for male, "F" for female and "X" for non-binary.

claveDeElectorstring

Clave de elector as read from id. For Mexican IDs only.

curpstring

Curp as read form id. For Mexican IDs only.

numeroEmisionCredencialstring

Numero Emision Credencial as read from id. (For Mexican IDs only).

cicstring

Cic as read from id. (This field is read from back side of id; For Mexican IDs only).

ocrstring

Ocr as read from id. (This field is read from back side of id; For Mexican IDs only).

documentNumberstring

Document number.

documentNumberSource'FORM' | 'OCR'

Document number source.

personalNumberstring

Personal number.

nationalNumberstring

National number.

refNumberstring

Document Reference Number.

taxIdNumberstring

Personal tax identification number.

nuestring

NUE number as read from id. (for Resident Cards)

externalIdstring

External user id.

issuedAtstring

Date of issue UTC timestamp.

expireAtstring

Expiration date UTC timestamp.

expirationDateinteger

Expiration year of id.

issueDateinteger

Issue year of id.

registrationDateinteger

Registration date read from id.

issuingCountrystring

Issuing country of document.

issuingStatestring

Issuing state of document.

birthPlacestring

Birth place as read from id.

issuingAuthoritystring

Issuing Authority as read from id.

heightstring

Person's height as read from id.

weightstring

Person's weight.

eyeColorstring

Person's eye color.

hairColorstring

Person's hair color.

religionstring

Person's religion.

bloodTypestring

Person's blood type.

maritalStatusstring

Person's marital status.

nationalitystring

Person's nationality.

racestring

Person's race.

nationalityMrzstring

Person's nationality as it appears in MRZ (if present).

nationalityAlpha3string

Person's nationality Alpha3 code format. Only for Brazilian IDs.

notExtractedinteger

Number of not extracted OCR fields. Only for Mexican IDs.

notExtractedDetailsstring[]
classesstring

Person's driver licence classes.

condstring

Person's driver licence conditions.

mentionsstring

Person's driver licence mentions.

restrictionsstring

Person's driver licence restrictions.

mrz1string

First MRZ line.

mrz2string

Second MRZ line.

mrz3string

Third MRZ line.

fullNameMrzstring

Person's full name read from MRZ.

documentNumberCheckDigitstring

Document number check digit read from MRZ.

dateOfBirthCheckDigitstring

Date of birth check digit read from MRZ.

expirationDateCheckDigitstring

Expiration date check digit read from MRZ.

barcodeRawDatastring

Full unformatted data read from 2D barcode.

fathersNamestring

Person's father's name. Only for Brazilian and Indian IDs.

mothersNamestring

Person's mother's name. Only for Brazilian IDs.

fathersIdNumberstring

Person's father's Id Number. In the context of minors identity validation.

mothersIdNumberstring

Person's mother's Id Number. In the context of minors identity validation.

spouseNamestring

Person's spouse's name.

federalRevenueNumberstring

Federal revenue number. Only for Brazilian IDs.

originDocumentIdstring

Origin document ID. Only for Brazilian IDs.

driversLicenseCategorystring

Driver's licence category. Only for Brazilian IDs.

controlNumberstring

Control number. Only for Brazilian IDs.

renachstring

Renach. Only for Brazilian IDs.

additionalAttrsstring[]

Additional document attributes.

documentSubmissionMethod'CAPTURED_DOCUMENT' | 'UPLOADED_FILE' | 'IMPORTED_CREDENTIAL'

Method used to submit the document.

credentialsProvider'APPLE' | 'GOOGLE' | 'DIGILOCKER' | 'SAMSUNG'

Credentials provider used when documentSubmissionMethod is IMPORTED_CREDENTIAL.