API Guide
  1. Vietnam
API Guide
  • Get Started
  • Document AI
    • Malaysia
      • Extract Bank Statement Data
      • Extract Bill of Lading Data
      • Extract Business Card Data
      • Extract Car Meter Data
      • Extract Cheque (Front) Data
      • Extract Company Financial Statement Data
      • Extract Resume Data
      • Extract E-Invoice Data
      • Extract Electricity Bill Data
      • Extract Identity Card Data
      • Extract Invoice Data
      • Extract Passport Data
      • Extract Payslip Data
      • Extract Price Tag Data
      • Extract Purchase Order Data
      • Extract Receipt (General) Data
      • Extract SSM Documents Data
      • Extract Water Bill Data
    • Thailand
      • Extract Business Card Data
      • Extract Identity Card Data
      • Extract Passport Data
      • Extract Receipt Data
    • Vietnam
      • Extract Business Card Data
        POST
      • Extract Identity Card Data
        POST
      • Extract Passport Data
        POST
      • Extract Receipt Data
        POST
    • Philippines
      • Extract Business Card Data
      • Extract Identity Card Data
      • Extract Passport Data
      • Extract Receipt Data
  1. Vietnam

Extract Business Card Data

POST
/document-ai/{model-id}

Extracted Data Types#

The following types will always be present in the API response. If a type parameter is not found in the input, its value will be null.
Parameter NameVariable Type
company_namestring | null
namestring | null
vietnamese_namestring | null
addressstring | null
vietnamese_addressstring | null
designationstring | null
vietnamese_designationstring | null
mobilestring | null
faxstring | null
emailstring | null
websitestring | null

Notes#

Each type parameter in the data array will always have the specified type, with the possibility of being null.
If a specific type parameter is not present in the input, its value in the response will be null.

Request

Authorization
Add parameter in header
X-API-KEY
Example:
X-API-KEY: ********************
Path Params
model-id
string 
required
To utilize the Axtraction AI API effectively, you must specify a model ID in your requests. The model ID follows the format model- followed by a 12-characters numbers and alphabet. This ID identifies the specific AI model you want to use for document processing.
If you do not have a model yet, you can create one by visiting the Axtraction AI web app. There, you can set up your model according to your requirements and obtain the corresponding model ID for your API requests.
Example:
model-a1b2c3d4e5f6
Body Params multipart/form-data
file
file 
optional
If fileBase64 is not provided, then file is required. Format: PDF, JPEG, PNG.
fileBase64
string 
optional
If file is not provided, then fileBase64 is required. If both file and fileBase64 are provided, only file will be used.
Example:
JVBERi0xLjMNCiXi48/....
mimeType
string 
optional
Required only when fileBase64 is provided. Supported: application/pdf, image/jpeg, image/jpg, image/png.
Example:
application/pdf

Request samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.axtraction.ai/v1/document/document-ai/model-a1b2c3d4e5f6' \
--header 'X-API-KEY;' \
--form 'file=@""' \
--form 'fileBase64="JVBERi0xLjMNCiXi48/...."' \
--form 'mimeType="application/pdf"'

Responses

🟢200Success
application/json
Body
success
boolean 
required
data
array [object {2}] 
required
type
string 
required
value
string  | null 
required
miscellaneous
object 
required
processedTime
number 
required
Example
{
    "success": true,
    "data": [
        {
            "type": "company_name",
            "value": "Công Ty Công Nghệ ABC"
        },
        {
            "type": "name",
            "value": "Nguyen Van A"
        },
        {
            "type": "vietnamese_name",
            "value": "Nguyễn Văn A"
        },
        {
            "type": "address",
            "value": "123 Đường Công Nghệ, Quận 1, TP.HCM"
        },
        {
            "type": "vietnamese_address",
            "value": "123 Đường Công Nghệ, Quận 1, TP.HCM"
        },
        {
            "type": "designation",
            "value": "Giám đốc"
        },
        {
            "type": "vietnamese_designation",
            "value": "Giám đốc"
        },
        {
            "type": "mobile",
            "value": "+84-912-345-678"
        },
        {
            "type": "fax",
            "value": "+84-28-1234-5678"
        },
        {
            "type": "email",
            "value": "nguyenvana@abc.com"
        },
        {
            "type": "website",
            "value": "www.abc.com.vn"
        }
    ],
    "miscellaneous": {
        "processedTime": 75.42
    }
}
Modified at 2025-05-13 04:16:20
Previous
Extract Receipt Data
Next
Extract Identity Card Data
Built with