Get a W-9
GET/api/v8/partner/w9s/:document_id
Veryfi's Get a W-9 endpoint allows you to retrieve a previously processed W-9.
Request
Path Parameters
The unique identifier of the document.
Query Parameters
This field was deprecated on 2023-08-20. Use bounding_boxes
and confidence_details
.
A field used to determine whether or not to return bounding_box and bounding_region
for extracted fields in the Document response.
A field used to determine whether or not to return the score
and ocr_score
fields in the Document response.
Responses
- 200
- 400
- 404
- 429
- 499
- 503
- default
Returns a processed W-9.
- application/json
- Schema
- Example (from schema)
Schema
- W9_V8
- 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
- ]
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.
The unique number created to identify the document.
The text returned from converting the document into a machine-readable text format.
The account numbers to a bank or brokerage account on Line 7 of the W-9.
The address (number, street, and apt. or suite no.) on Line 5 of the W-9.
The city, state, and zip on Line 6 of the W-9.
The business name on Line 2 of the W-9.
A boolean indicating whether or not the LLC is identified as a C Corp and was checked in Box 3 of the W-9.
The Employer Identification Number (EIN) in Part I - Taxpayer Identification Number (TIN) on the W-9.
The exemption payee code in Box 4 of the W-9.
The exemption in Box 4 of the W-9.
A boolean indicating whether or not Individual was checked in Box 3 of the W-9.
A boolean indicating whether or not Limited Liability Company was checked in Box 3 of the W-9.
Possible values: [C
, S
, P
]
The tax classification found in Box 3 of the W-9.
The full name found on Line 1 of the W-9.
The comments or description found on the Other line in Box 3 of the W-9.
A boolean indicating whether or not the Other box was checked in Box 3 of the W-9.
A boolean indicating whether or not the LLC is identified as a Partnership and was checked in Box 3 of the W-9.
The requestor's name and address in the Box to the right of Line 5 of the W-9
A boolean indicating whether or not the LLC is identified as a S Corp and was checked in Box 3 of the W-9.
The date found on the Sign Here line under Part II - Certification of the W-9.
The signature found on the Sign Here line under Part II - Certification of the W-9
The number found on Part I Taxpayer Identification Number (TIN) under Social Security Number of the W-9.
A boolean indicating whether or not Trust/estate was checked in Box 3 of the W-9.
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.
The unique number created to identify the document.
The text returned from converting the document into a machine-readable text format.
account_numbers object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
address1 objectrequired
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
address2 object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
business_name object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
c_corp object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
ein object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
exempt_payee_code object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
exemption object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
individual object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
llc object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
llc_type object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: [C
, S
, P
]
The tax classification found in Box 3 of the W-9.
name object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
other_description object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
other object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
partnership object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
requester object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
s_corp object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
signature_date object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
signature object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
ssn object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
Possible values: non-empty
The extracted value.
trust_estate object
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: >= 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.
Possible values: <= 1
The score which shows how confident the model in recognizing value
symbols. See confidence scores explained for more information.
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: [0
, 90
, 180
, 270
]
The angle of rotation of the document in degrees.
{}
User error
- application/json
- Schema
- Example (from schema)
Schema
- MALFORMED_PARAMETERS
Default value: fail
Default value: Malformed parameters
Default value: [object Object]
{}
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
{}
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 temporaly unavailable
- application/json
- Schema
- Example (from schema)
Schema
- SERVICE_IS_TEMPORALY_UNAVAILABLE_PLEASE_TRY_AGAIN_LATER
Default value: fail
Default value: Service is temporaly unavailable. Please try again later
{}
OperationStatus
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [fail
, ok
]
{
"status": "fail",
"error": "string",
"message": "string",
"details": [
{}
]
}