Process a Business Card
POST/api/v8/partner/business-cards
Veryfi's Process a Business Card endpoint allows you to submit and extract data from unstructured documents such as Business Cards and turn them into valuable business insights. The Process a Business Card endpoint enables you to submit the following image formats: .jpg,.png,.pdf,.zip,.jpeg and retrieve extracted data in JSON format. The max file size is 20mb, min file size is 1kb. Rate limit is 60 requests per second.
Request
- application/json
- multipart/form-data
Body
Possible values: non-empty
Default value: ``
Tags you want to associate with the document.
Possible values: non-empty
A path to a file in an S3 bucket, e.g. 'some/receipt.jpg
Possible values: non-empty
An S3 bucket for 'package_path', e.g. 'documents'.
Possible values: non-empty
Used to upload a document via base64 encoded string, could be raw or data URI scheme. This is the least effective way to upload a document for processing. See file_urls
or uploading zip files.
Possible values: non-empty
A URL to a publicly accessible document to be sent to Veryfi for processing.
Possible values: non-empty
An array of URLs to publicly accessible documents to be sent to Veryfi for processing.
Possible values: non-empty
An optional filename. Useful to determine file type.
Possible values: non-empty
A custom identification value. Use this if you would like to assign your own ID to documents. This parameter is useful when mapping this document to a service or resource outside Veryfi.
Default value: false
Delete this business_card from Veryfi after data has been extracted
Body
Possible values: non-empty
Default value: ``
Tags you want to associate with the document.
Possible values: non-empty
A path to a file in an S3 bucket, e.g. 'some/receipt.jpg
Possible values: non-empty
An S3 bucket for 'package_path', e.g. 'documents'.
Possible values: non-empty
Used to upload a document via base64 encoded string, could be raw or data URI scheme. This is the least effective way to upload a document for processing. See file_urls
or uploading zip files.
Possible values: non-empty
A URL to a publicly accessible document to be sent to Veryfi for processing.
Possible values: non-empty
An array of URLs to publicly accessible documents to be sent to Veryfi for processing.
Possible values: non-empty
An optional filename. Useful to determine file type.
Possible values: non-empty
A custom identification value. Use this if you would like to assign your own ID to documents. This parameter is useful when mapping this document to a service or resource outside Veryfi.
A binary file. Submitting zipped documents through this parameter is the fastest way to process any document.
Default value: false
Delete this business_card from Veryfi after data has been extracted
Responses
- 201
- 400
- 403
- 404
- 413
- 429
- 499
- 503
- 504
- default
Returns a processed Business Card.
- application/json
- Schema
- Example (from schema)
Schema
- API_V8_PARTNER_BUSINESSCARDS_BUSINESSCARDV8
- API_V8_PARTNER_BUSINESSCARDS_DETAILEDBUSINESSCARDV8
- Array [
- ]
- MOD1
- MOD2
- MOD1
- MOD2
- Array [
- ]
- Array [
- MOD1
- MOD2
- ]
- Array [
- MOD1
- MOD2
- ]
- MOD1
- MOD2
- Array [
- MOD1
- MOD2
- ]
- Array [
- MOD1
- MOD2
- ]
- Array [
- MOD1
- MOD2
- ]
- Array [
- MOD1
- MOD2
- ]
- Array [
- MOD1
- MOD2
- ]
- Array [
- MOD1
- MOD2
- ]
- Array [
- MOD1
- MOD2
- ]
- Array [
- MOD1
- MOD2
- ]
Possible values: non-empty
A custom identification value. Use this if you would like to assign your own ID to documents. This parameter is useful when mapping this document to a service or resource outside Veryfi.
meta object
Possible values: non-empty
A custom identification value. Use this if you would like to assign your own ID to documents. This parameter is useful when mapping this document to a service or resource outside Veryfi.
pages object[]
Possible values: <= 1
The average OCR score of the page.
The width of the page.
The height of the page.
Possible values: non-empty
Default value: ``
Tags associated with the document.
Possible values: <= 1
The average OCR score of the whole document.
Possible values: non-empty
The version of the model used to process the document.
The text returned from converting the document into a machine-readable text format.
The unique number created to identify the document.
The name of the business found on the document.
logo_url object required
A signed URL to the logo for the organization found on the document. The URL expires 15 minutes after the Document Response is returned and is re-assigned on every GET request.
string
string
img_url object required
string
string
The full name of the individual found on the document.
parsed_name objectrequired
An object that represents the person found on the document.
The last name or found on the document.
The first name found on the document.
The job title of the person found on the document.
The email address found on the document.
The address found on the document.
parsed_address objectrequired
An object representing detailed address-related information on the document, such as the city, state, street address, unit number, etc.
Possible values: non-empty
The building name e.g. 'Project 8' or 'Empire State Building'
Possible values: non-empty
The settlement including cities, towns, villages, hamlets, localities, etc.
Possible values: non-empty
The sovereign nations and their dependent territories, anything with an ISO-3166 code.
Possible values: non-empty
The detected ISO 3166-1 alpha-2 code for a given country.
Possible values: non-empty
The postal code used for mail sorting
Possible values: non-empty
A first-level administrative division. Scotland, Northern Ireland, Wales, and England in the UK are mapped to "state" as well
Possible values: non-empty
A sum of house_number
road, building, unit.
Possible values: non-empty
The venue name e.g. "Brooklyn Academy of Music", and building names e.g. "Empire State Building".
Possible values: non-empty
Usually refers to the external (street-facing) building number. In some countries this may be a compound, hyphenated number, which also includes an apartment number, or a block number (a la Japan).
Possible values: non-empty
Street name(s)
Possible values: non-empty
An apartment, unit, office, lot, or other secondary unit designator.
Possible values: non-empty
The expressions indicating a floor number e.g. "3rd Floor", "Ground Floor", etc.
Possible values: non-empty
Numbered/lettered staircase
Possible values: non-empty
Numbered/lettered entrance
Possible values: non-empty
The post office box, typically found in non-physical (mail-only) addresses.
Possible values: non-empty
An unofficial neighborhood name like "Harlem", "South Bronx", or "Crown Heights".
Possible values: non-empty
The boroughs or districts within a city that serve some official purpose e.g. "Brooklyn" or "Hackney" or "Bratislava IV".
Possible values: non-empty
Named islands e.g. "Maui"
Possible values: non-empty
Usually a second-level administrative division or county.
Possible values: non-empty
Informal subdivision of a country without any political status.
Possible values: non-empty
Only used for appending "West Indies" after the country name, a pattern frequently used in the English-speaking Caribbean e.g. "Jamaica, West Indies".
The mobile number found on the document.
The phone number found on the document.
The fax number found on the document.
The web page found on the document.
Possible values: non-empty
A custom identification value. Use this if you would like to assign your own ID to documents. This parameter is useful when mapping this document to a service or resource outside Veryfi.
meta object
Possible values: non-empty
A custom identification value. Use this if you would like to assign your own ID to documents. This parameter is useful when mapping this document to a service or resource outside Veryfi.
pages object[]
Possible values: <= 1
The average OCR score of the page.
The width of the page.
The height of the page.
Possible values: non-empty
Default value: ``
Tags associated with the document.
Possible values: <= 1
The average OCR score of the whole document.
Possible values: non-empty
The version of the model used to process the document.
The text returned from converting the document into a machine-readable text format.
The unique number created to identify the document.
organization objectrequired
The name of the business found on the document.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: >= 8
, <= 8
An array containing (x,y) coordinates in the format
[x1,y1,x2,y2,x3,y3,x4,y4]` for skewed images and handwritten fields. The bounding region is more precise than bounding box, otherwise it's the same.
bounding_box object[]
Possible values: >= 5
, <= 5
An array containing relative coordinates in the format [page_number,x1,y1,x2,y2]
for the extracted field from img_url
before any rotation.
number
integer
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
Possible values: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
logo_url objectrequired
A signed URL to the logo for the organization found on the document. The URL expires 15 minutes after the Document Response is returned and is re-assigned on every GET request.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: >= 8
, <= 8
An array containing (x,y) coordinates in the format
[x1,y1,x2,y2,x3,y3,x4,y4]` for skewed images and handwritten fields. The bounding region is more precise than bounding box, otherwise it's the same.
bounding_box object[]
Possible values: >= 5
, <= 5
An array containing relative coordinates in the format [page_number,x1,y1,x2,y2]
for the extracted field from img_url
before any rotation.
number
integer
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
Possible values: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
img_url object required
string
string
person objectrequired
The full name of the individual found on the document.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: >= 8
, <= 8
An array containing (x,y) coordinates in the format
[x1,y1,x2,y2,x3,y3,x4,y4]` for skewed images and handwritten fields. The bounding region is more precise than bounding box, otherwise it's the same.
bounding_box object[]
Possible values: >= 5
, <= 5
An array containing relative coordinates in the format [page_number,x1,y1,x2,y2]
for the extracted field from img_url
before any rotation.
number
integer
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
Possible values: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
parsed_name objectrequired
An object that represents the person found on the document.
family_name object
The last name or found on the document.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
given_name object
The first name found on the document.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
middle_name object
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
suffix object
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
prefix object
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
title objectrequired
The job title of the person found on the document.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: >= 8
, <= 8
An array containing (x,y) coordinates in the format
[x1,y1,x2,y2,x3,y3,x4,y4]` for skewed images and handwritten fields. The bounding region is more precise than bounding box, otherwise it's the same.
bounding_box object[]
Possible values: >= 5
, <= 5
An array containing relative coordinates in the format [page_number,x1,y1,x2,y2]
for the extracted field from img_url
before any rotation.
number
integer
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
Possible values: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
email objectrequired
The email address found on the document.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: >= 8
, <= 8
An array containing (x,y) coordinates in the format
[x1,y1,x2,y2,x3,y3,x4,y4]` for skewed images and handwritten fields. The bounding region is more precise than bounding box, otherwise it's the same.
bounding_box object[]
Possible values: >= 5
, <= 5
An array containing relative coordinates in the format [page_number,x1,y1,x2,y2]
for the extracted field from img_url
before any rotation.
number
integer
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
Possible values: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
address objectrequired
The address found on the document.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: >= 8
, <= 8
An array containing (x,y) coordinates in the format
[x1,y1,x2,y2,x3,y3,x4,y4]` for skewed images and handwritten fields. The bounding region is more precise than bounding box, otherwise it's the same.
bounding_box object[]
Possible values: >= 5
, <= 5
An array containing relative coordinates in the format [page_number,x1,y1,x2,y2]
for the extracted field from img_url
before any rotation.
number
integer
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
Possible values: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
parsed_address objectrequired
An object representing detailed address-related information on the document, such as the city, state, street address, unit number, etc.
building object
The building name e.g. 'Project 8' or 'Empire State Building'
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
city object
The settlement including cities, towns, villages, hamlets, localities, etc.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
country object
The sovereign nations and their dependent territories, anything with an ISO-3166 code.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
country_alpha_2 object
The detected ISO 3166-1 alpha-2 code for a given country.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
postcode object
The postal code used for mail sorting
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
state object
A first-level administrative division. Scotland, Northern Ireland, Wales, and England in the UK are mapped to "state" as well
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
street_address object
A sum of house_number
road, building, unit.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
house object
The venue name e.g. "Brooklyn Academy of Music", and building names e.g. "Empire State Building".
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
house_number object
Usually refers to the external (street-facing) building number. In some countries this may be a compound, hyphenated number, which also includes an apartment number, or a block number (a la Japan).
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
road object
Street name(s)
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
unit object
An apartment, unit, office, lot, or other secondary unit designator.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
level object
The expressions indicating a floor number e.g. "3rd Floor", "Ground Floor", etc.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
staircase object
Numbered/lettered staircase
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
entrance object
Numbered/lettered entrance
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
po_box object
The post office box, typically found in non-physical (mail-only) addresses.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
suburb object
An unofficial neighborhood name like "Harlem", "South Bronx", or "Crown Heights".
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
city_district object
The boroughs or districts within a city that serve some official purpose e.g. "Brooklyn" or "Hackney" or "Bratislava IV".
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
island object
Named islands e.g. "Maui"
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
state_district object
Usually a second-level administrative division or county.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
country_region object
Informal subdivision of a country without any political status.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
world_region object
Only used for appending "West Indies" after the country name, a pattern frequently used in the English-speaking Caribbean e.g. "Jamaica, West Indies".
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: non-empty
The extracted value.
mobile objectrequired
The mobile number found on the document.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: >= 8
, <= 8
An array containing (x,y) coordinates in the format
[x1,y1,x2,y2,x3,y3,x4,y4]` for skewed images and handwritten fields. The bounding region is more precise than bounding box, otherwise it's the same.
bounding_box object[]
Possible values: >= 5
, <= 5
An array containing relative coordinates in the format [page_number,x1,y1,x2,y2]
for the extracted field from img_url
before any rotation.
number
integer
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
Possible values: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
phone objectrequired
The phone number found on the document.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: >= 8
, <= 8
An array containing (x,y) coordinates in the format
[x1,y1,x2,y2,x3,y3,x4,y4]` for skewed images and handwritten fields. The bounding region is more precise than bounding box, otherwise it's the same.
bounding_box object[]
Possible values: >= 5
, <= 5
An array containing relative coordinates in the format [page_number,x1,y1,x2,y2]
for the extracted field from img_url
before any rotation.
number
integer
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
Possible values: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
fax objectrequired
The fax number found on the document.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: >= 8
, <= 8
An array containing (x,y) coordinates in the format
[x1,y1,x2,y2,x3,y3,x4,y4]` for skewed images and handwritten fields. The bounding region is more precise than bounding box, otherwise it's the same.
bounding_box object[]
Possible values: >= 5
, <= 5
An array containing relative coordinates in the format [page_number,x1,y1,x2,y2]
for the extracted field from img_url
before any rotation.
number
integer
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
Possible values: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
web objectrequired
The web page found on the document.
Possible values: <= 1
The score shows how confident the model is that the predicted value
belongs to the field. See confidence scores explained for more information.
Possible values: >= 8
, <= 8
An array containing (x,y) coordinates in the format
[x1,y1,x2,y2,x3,y3,x4,y4]` for skewed images and handwritten fields. The bounding region is more precise than bounding box, otherwise it's the same.
bounding_box object[]
Possible values: >= 5
, <= 5
An array containing relative coordinates in the format [page_number,x1,y1,x2,y2]
for the extracted field from img_url
before any rotation.
number
integer
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
Possible values: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
{}
User error
- application/json
- Schema
- Example (from schema)
Schema
- FAILED_TO_PROCESS_DOCUMENTS
- FAILED_TO_EXTRACT
Default value: fail
Default value: Failed to process documents
Default value: fail
Default value: Failed to extract
{}
User error
- application/json
- Schema
- Example (from schema)
Schema
- AUTHENTICATION_CREDENTIALS_WERE_NOT_PROVIDED
Default value: fail
Default value: Authentication credentials were not provided.
{}
Not found
- application/json
- Schema
- Example (from schema)
Schema
- NOT_FOUND
- DOCUMENT_NOT_FOUND
Default value: fail
Default value: Not found.
Default value: fail
Default value: Document Not Found
{}
Request body too large
- application/json
- Schema
- Example (from schema)
Schema
- REQUEST_BODY_TOO_LARGE
Default value: fail
Default value: Request body too large
{}
Rate limit
- application/json
- Schema
- Example (from schema)
Schema
- YOU_HAVE_BEEN_RATE_LIMITED
Default value: fail
Default value: You have been rate limited
Default value: [object Object]
{}
User error
- application/json
- Schema
- Example (from schema)
Schema
- CLIENT_CLOSED_REQUEST_OR_LOST_CONNECTION
Default value: fail
Default value: Client closed request or lost connection
{}
Service is temporarily unavailable
- application/json
- Schema
- Example (from schema)
Schema
- SERVICE_IS_TEMPORARILY_UNAVAILABLE_PLEASE_TRY_AGAIN_LATER
Default value: fail
Default value: Service is temporarily unavailable. Please try again later
{}
Gateway timeout. Returned if request takes more than 150 seconds. The request might finish successfully later.
- application/json
- Schema
- Example (from schema)
Schema
- GATEWAY_TIMEOUT
Default value: fail
Default value: Gateway timeout
{}
OperationStatus
- application/json
- Schema
- Example (from schema)
Schema
Default value: fail
{
"status": "fail",
"error": "string",
"details": [
{}
]
}