FormX.ai
FormX.ai
Signup/Login
Search…
FormX Documentation and Guide
Basics
Get started
Set up a form with a master image
Set up a form without a master image
Which features should I use?
Use cases
Official Forms or Certificates
Receipts or Tickets
Customization Services
Passport & ID Cards
Features
Pre-defined Documents
Key Value Pattern Detection
Token Group
Auto Extraction Items
Labelling Areas
Post-Processing Scripts
Import and Export Forms
Teams and Server Location
Webhook Integration
API References
Document Extraction
Post-Processing Scripts
Detect documents from an image
Contact Us
Powered By
GitBook
Passport & ID Cards
You can use FormX to extract information from identity documents such as passports, ID cards and driver's license.
List of supported Countries and ID
Country
Type
All countries
Passport
Hong Kong
Identity Card
Taiwan
National Identification Card
Macau
Identity Card
Singapore
NRIC, Work passes
This is a growing list.
Contact us
if the ID you need is not listed here.
How to use
1.
Select
International ID
from the side bar in the portal.
2.
Test your photos by uploading them to the "Test" tab.
3.
Copy "Access Token" and "Form ID" to use the extractor via RESTful API. See
API Reference
.
Attributes
These are the attributes that are extracted from the identity documents. The attributes that are unavailable from the documents will not be returned.
Attribute name
Meaning
Value
type_of_id
The type of document
type.country.subdivision e.g. `id.hkg` , `driverslicense.usa.ny` , `other`
name
Full name of the holder
String, Variable length in latin script
surname
Surname/Family name of the holder
String, Variable length in latin script
given_names
Given names of the holder
String, Variable length in latin script
name-(two letter lang code) e.g. name-zh / name-ko
Name of the holder in non-latin script
String, Variable length in non-latin script
surname-(two letter lang code) e.g. surname-zh
Surname/Family name of the holder in non-latin script
String, Variable length in non-latin script
given_names-(two letter lang code) e.g. given_names-zh
given names of the holder in non-latin script
String, Variable length in non-latin script
date_of_birth
Date of birth of the holder
YYYY-MM-DD or YYYY-MM or YYYY
date_of_issue
Issue date of the document
YYYY-MM-DD
date_of_expiry
Expiry date of the document
YYYY-MM-DD
sex
Sex or gender of the holder
M, F, or X
place_of_birth
City or State of the holder’s birthplace
String, Variable length
nationality
Nationality of the holder as printed on the document
String, Variable length
nationality_code
Nationality of the holder in 3-letter code as defined in ICAO Doc 9303-3
String, three letters
issuing_authority
Issuing organization of the document as printed in the document
String, Variable length
personal_number
Personal identification number given to holder by the issuing State or organization.
String, Variable length e.g. HKID number: A123456(7)
document_number
The number given by the issuer to identify the document
String, Variable length
portrait
The bounding box of the portrait of the holder
Array [x1,y1,x2,y2]
signature
The bounding box of the signature of the holder
Array [x1,y1,x2,y2]
address
Address of the holder
String, Variable length
Previous
Customization Services
Next - Features
Pre-defined Documents
Last modified
1mo ago
Copy link
Outline
List of supported Countries and ID
How to use
Attributes