Skip to main content

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

Body

    meta.tags string[]

    Possible values: non-empty

    Default value: ``

    Tags you want to associate with the document.

    package_path string

    Possible values: non-empty

    A path to a file in an S3 bucket, e.g. 'some/receipt.jpg

    bucket string

    Possible values: non-empty

    An S3 bucket for 'package_path', e.g. 'documents'.

    file_data string

    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.

    file_url string

    Possible values: non-empty

    A URL to a publicly accessible document to be sent to Veryfi for processing.

    file_urls string[]

    Possible values: non-empty

    An array of URLs to publicly accessible documents to be sent to Veryfi for processing.

    file_name string

    Possible values: non-empty

    An optional filename. Useful to determine file type.

    external_id string

    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.

    auto_delete boolean

    Default value: false

    Delete this business_card from Veryfi after data has been extracted

Responses

Returns a processed Business Card.

Schema
    anyOf
    external_id string

    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
    external_id string

    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[]
  • Array [
  • ocr_score number

    Possible values: <= 1

    The average OCR score of the page.

    width integer

    The width of the page.

    height integer

    The height of the page.

  • ]
  • tags string[]

    Possible values: non-empty

    Default value: ``

    Tags associated with the document.

    ocr_score number

    Possible values: <= 1

    The average OCR score of the whole document.

    model string

    Possible values: non-empty

    The version of the model used to process the document.

    text string

    The text returned from converting the document into a machine-readable text format.

    id integerrequired

    The unique number created to identify the document.

    created_date date-timerequired
    updated_date date-timerequired
    organization stringrequired

    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.

    anyOf

    string

    img_url object required
    anyOf

    string

    person stringrequired

    The full name of the individual found on the document.

    parsed_name objectrequired

    An object that represents the person found on the document.

    family_name string

    The last name or found on the document.

    given_name string

    The first name found on the document.

    middle_name string
    suffix string
    prefix string
    title stringrequired

    The job title of the person found on the document.

    email stringrequired

    The email address found on the document.

    address stringrequired

    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.

    building string

    Possible values: non-empty

    The building name e.g. 'Project 8' or 'Empire State Building'

    city string

    Possible values: non-empty

    The settlement including cities, towns, villages, hamlets, localities, etc.

    country string

    Possible values: non-empty

    The sovereign nations and their dependent territories, anything with an ISO-3166 code.

    country_alpha_2 string

    Possible values: non-empty

    The detected ISO 3166-1 alpha-2 code for a given country.

    postcode string

    Possible values: non-empty

    The postal code used for mail sorting

    state string

    Possible values: non-empty

    A first-level administrative division. Scotland, Northern Ireland, Wales, and England in the UK are mapped to "state" as well

    street_address string

    Possible values: non-empty

    A sum of house_number road, building, unit.

    house string

    Possible values: non-empty

    The venue name e.g. "Brooklyn Academy of Music", and building names e.g. "Empire State Building".

    house_number string

    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).

    road string

    Possible values: non-empty

    Street name(s)

    unit string

    Possible values: non-empty

    An apartment, unit, office, lot, or other secondary unit designator.

    level string

    Possible values: non-empty

    The expressions indicating a floor number e.g. "3rd Floor", "Ground Floor", etc.

    staircase string

    Possible values: non-empty

    Numbered/lettered staircase

    entrance string

    Possible values: non-empty

    Numbered/lettered entrance

    po_box string

    Possible values: non-empty

    The post office box, typically found in non-physical (mail-only) addresses.

    suburb string

    Possible values: non-empty

    An unofficial neighborhood name like "Harlem", "South Bronx", or "Crown Heights".

    city_district string

    Possible values: non-empty

    The boroughs or districts within a city that serve some official purpose e.g. "Brooklyn" or "Hackney" or "Bratislava IV".

    island string

    Possible values: non-empty

    Named islands e.g. "Maui"

    state_district string

    Possible values: non-empty

    Usually a second-level administrative division or county.

    country_region string

    Possible values: non-empty

    Informal subdivision of a country without any political status.

    world_region string

    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".

    mobile stringrequired

    The mobile number found on the document.

    phone stringrequired

    The phone number found on the document.

    fax stringrequired

    The fax number found on the document.

    web stringrequired

    The web page found on the document.

Loading...