# Update a W-9

PUT## /api/v8/partner/w9s/:document_id

Veryfi's Update a Document by ID endpoint allows you to change a Document that Veryfi's Machine Learning models have already processed. This feature will enable users to update Documents previously processed by Veryfi to ensure data extraction accuracy. Updating a Document is especially useful for correcting mistakes and updating information over time. By changing a processed Document, Veryfi's Machine Learning models can re-learn the updated information, allowing them to stay accurate and up-to-date.

## Request

### Path Parameters

**document_id**int64required

The unique identifier of the document.

### Query Parameters

**external_id**string

## Responses

- 200
- 400
- 404
- 429
- 499
- 503
- 504
- default

A processed W-9 response.

- application/json

- Schema
- Example (from schema)

**Schema**

- DetailedW9_V8
- Array [
- 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
- ]
- Array [
- 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
- ]
- Array [
- MOD1
- MOD2
- ]
- Array [
- MOD1
- MOD2
- ]
- Array [
- MOD1
- MOD2
- ]
- Array [
- MOD1
- MOD2
- ]

**pdf_url**uri

**Possible values:** `non-empty`

and `<= 2083 characters`

A signed URL to access the auto-generated PDF created from the submitted document. This URL expires 15 minutes after the response object is returned and is resigned during every GET request.

**id**integerrequired

The unique number created to identify the document.

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

**created_date**date-timerequired

**updated_date**date-timerequired

**img_thumbnail_url**uri

**Possible values:** `non-empty`

and `<= 2083 characters`

A signed URL to access the auto-generated thumbnail created for the submitted document. This URL expires 15 minutes after the response object is returned and is resigned during every GET request.

**text**string

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

**account_numbers** objectrequired

The account numbers to a bank or brokerage account on Line 7 of the W-9.

**bounding_region**number[]

**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

**ocr_score**number

**Possible values:** `<= 1`

The score which shows how confident the model in recognizing `value`

symbols. See confidence scores explained for more information.

**score**number

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

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**address1** objectrequired

The address (number, street, and apt. or suite no.) on Line 5 of the W-9.

**bounding_region**number[]

**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

**ocr_score**number

**Possible values:** `<= 1`

The score which shows how confident the model in recognizing `value`

symbols. See confidence scores explained for more information.

**score**number

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

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**address2** objectrequired

The city, state, and zip on Line 6 of the W-9.

**bounding_region**number[]

**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

**ocr_score**number

**Possible values:** `<= 1`

The score which shows how confident the model in recognizing `value`

symbols. See confidence scores explained for more information.

**score**number

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

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**parsed_address** object

An object representing detailed address-related information on the document, such as the city, state, street address, unit number, etc. Filled in the original POST request had the parameter `parse_address`

set to `true`

and the corresponding address is found on the document.

**city** object

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

**score**number

**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. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**country** object

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

**score**number

**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. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**country_alpha_2** object

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

**score**number

**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. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**postcode** object

The postal code used for mail sorting

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**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

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**street_address** object

A sum of `house_number`

road, building, unit.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

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

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

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

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**road** object

Street name(s)

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**unit** object

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

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**level** object

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

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**staircase** object

Numbered/lettered staircase

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**entrance** object

Numbered/lettered entrance

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**po_box** object

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

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**suburb** object

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

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

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

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**island** object

Named islands e.g. "Maui"

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**state_district** object

Usually a second-level administrative division or county.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**country_region** object

Informal subdivision of a country without any political status.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

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

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information. Returned with `confidence_details: true`

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**business_name** objectrequired

The business name on Line 2 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**c_corp** objectrequired

A boolean indicating whether or not the LLC is identified as a C Corp and was checked in Box 3 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**booleanrequired

**ein** objectrequired

The Employer Identification Number (EIN) in Part I - Taxpayer Identification Number (TIN) on the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**exempt_payee_code** objectrequired

The exemption payee code in Box 4 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**exemption** objectrequired

The exemption in Box 4 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**individual** objectrequired

A boolean indicating whether or not Individual was checked in Box 3 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**booleanrequired

**llc** objectrequired

A boolean indicating whether or not Limited Liability Company was checked in Box 3 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**booleanrequired

**llc_type** objectrequired

The tax classification found in Box 3 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** [`C`

, `S`

, `P`

]

The tax classification found in Box 3 of the W-9.

**name** objectrequired

The full name found on Line 1 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**other_description** objectrequired

The comments or description found on the Other line in Box 3 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**other** objectrequired

A boolean indicating whether or not the Other box was checked in Box 3 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**booleanrequired

**partnership** objectrequired

A boolean indicating whether or not the LLC is identified as a Partnership and was checked in Box 3 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**booleanrequired

**requester** objectrequired

The requestor's name and address in the Box to the right of Line 5 of the W-9

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**s_corp** objectrequired

A boolean indicating whether or not the LLC is identified as a S Corp and was checked in Box 3 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**booleanrequired

**signature_date** objectrequired

The date found on the Sign Here line under Part II - Certification of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**signature** objectrequired

The signature found on the Sign Here line under Part II - Certification of the W-9

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**booleanrequired

**ssn** objectrequired

The number found on Part I Taxpayer Identification Number (TIN) under Social Security Number of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**stringrequired

**Possible values:** `non-empty`

The extracted value.

**trust_estate** objectrequired

A boolean indicating whether or not Trust/estate was checked in Box 3 of the W-9.

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**booleanrequired

**3b_foreign** objectrequired

**bounding_region**number[]

**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`

`[page_number,x1,y1,x2,y2]`

for the extracted field from `img_url`

before any rotation.

number

integer

**ocr_score**number

**Possible values:** `<= 1`

`value`

symbols. See confidence scores explained for more information.

**score**number

**Possible values:** `<= 1`

`value`

belongs to the field. See confidence scores explained for more information.

**rotation**integer

**Possible values:** [`0`

, `90`

, `180`

, `270`

]

The angle of rotation of the document in degrees.

**value**booleanrequired

`{}`

User error

- application/json

- Schema
- Example (from schema)

**Schema**

- MALFORMED_PARAMETERS

**status**string

**Default value:** `fail`

**error**string

**Default value:** `Malformed parameters`

**details**undefined[]

**Default value:** `[object Object]`

`{}`

Not found

- application/json

- Schema
- Example (from schema)

**Schema**

- NOT_FOUND
- DOCUMENT_NOT_FOUND

**status**string

**Default value:** `fail`

**error**string

**Default value:** `Not found.`

**status**string

**Default value:** `fail`

**error**string

**Default value:** `Document Not Found`

`{}`

Rate limit

- application/json

- Schema
- Example (from schema)

**Schema**

- YOU_HAVE_BEEN_RATE_LIMITED

**status**string

**Default value:** `fail`

**error**string

**Default value:** `You have been rate limited`

**details**undefined[]

**Default value:** `[object Object]`

`{}`

User error

- application/json

- Schema
- Example (from schema)

**Schema**

- CLIENT_CLOSED_REQUEST_OR_LOST_CONNECTION

**status**string

**Default value:** `fail`

**error**string

**Default value:** `Client closed request or lost connection`

`{}`

Service is temporaly unavailable

- application/json

- Schema
- Example (from schema)

**Schema**

- SERVICE_IS_TEMPORALY_UNAVAILABLE_PLEASE_TRY_AGAIN_LATER

**status**string

**Default value:** `fail`

**error**string

**Default value:** `Service is temporaly 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

**status**string

**Default value:** `fail`

**error**string

**Default value:** `Gateway timeout`

`{}`

OperationStatus

- application/json

- Schema
- Example (from schema)

**Schema**

**status**string

**Default value:** `fail`

**error**stringrequired

**details**object[]

`{`

"status": "fail",

"error": "string",

"details": [

{}

]

}