Skip to main content
Version: 1.7.3

Get

This endpoint will return the completed W-9 of a particular recipient. The response will comprise the W-9 information, such as the Name, Address, and TIN, along with a link to download the completed Form W-9.

Key Points

  • Only the W-9s with the ‘COMPLETED’ and ‘COMPLETED_AND_TIN_MATCH_INPROGRESS’ statuses can be retrieved using the Get method.
  • If you do not provide the BusinessId in the request, then the W-9 that matches the Email or PayeeRef linked to the default business will be retrieved.
  • If there are multiple W-9s for the same Email or PayeeRef, the most recently completed W-9 will be retrieved.
GET FormW9/Get 
Run in Postman

Request Params

FieldTypeDescription
PayeeRefStringA unique identifier of the recipient(Either PayeeRef or Email is required)
Size Range: 1-50
EmailStringEmail Address of the recipient.
Size Range: 1-50
BusinessIdGuidOptional Unique Business Identifier. If you do not provide the BusinessId in the request, the BusinessId of the default business will be mapped.
TINStringOptional Taxpayer Identification Number.Use this as an alternate for BusinessId. (Values: EIN, SSN)
Size Range: 9-11

Request Params

Get the W-9 data of the recipient with PayeeRef and BusinessId

FormW9/Get?PayeeRef=Pe123451234&BusinessId=7B82B242-1223-4029-9251-C0446298F620

Response Body

FieldTypeDescription
SubmissionIdGuidA Unique identifier of the submission.
RequesterObjectRequester information.
    BusinessIdGuidA unique identifier of the business.
    BusinessNmStringRequester name. If the requester is a business, then the Business Name will be returned. If the requester is an individual, then the Payer’s full name will be returned.
    TINTypeStringTIN Type of the requester.
    TINStringTaxpayer Identification Number of the requester.
PayeeRefStringA unique identifier of the recipient.
RecipientIdGuidA unique ID generated by TaxBandits after the return is created and will be returned in the response. You can use this id for your future reference to update.
W9StatusStringStatus of the W-9.
StatusTsStringTimestamp of the W-9 Status
TINMatchingObjectTIN Matching information.
    StatusStringTIN Matching status.
    StatusTsStringTimestamp of the TIN Matching Status.
    ErrorsStringShows the detailed error message.
FormW9RequestTypeStringForm W-9 requested Type.
  • URL_API - Form W-9 was requested using the RequestByURL method.
  • Email_API - Form W-9 was requested using the RequestByEmail method.
  • Email_UI - Form W-9 was requested from the TaxBandits UI application.
PdfUrlStringURL to download the completed W-9.
EmailStringEmail Address of the recipient. This is the email to which the W-9 request was sent. The value will be null if the Form W-9 was requested using the RequestByUrl method.
FormDataObjectForm W-9 data of the recipient
    Line1NmstringName as shown on the income tax return
    Line2NmstringBusiness name/disregarded entity name (if different from Line1 Name)
    TINTypestringTIN type of the recipient.(EIN or SSN)
    TINstringRecipient’s TIN
Size Range: 9
    AddressObjectRecipient’s complete address
        Address1stringRecipient’s Address 1 (number, street)
Size Range: 35
        Address2stringRecipient’s Address 2 (apt. or suite no.)
Size Range: 35
        CitystringRecipient’s City
Size Range: 27
        StatestringRecipient’s State
Size Range: 2
        ZipCdstringRecipient’s Zip Code
Size Range: 5,9
    FederalTaxClassificationstringU.S. Federal Tax Classification of the person whose name is entered on Line 1
    ExemptPayeeCdstringThis code indicates that the recipient is exempt from backup withholding
    ExemptFromFATCAstringThis code indicates that the recipient is exempt from reporting under FATCA.
        ErrorsObject[]Collection of errors for the Recipient
         IdstringError ID number. This ID is assigned by TaxBandits and it is unique for each error.
         NamestringName of the errored node.
         MessagestringShows the error message

Response JSON

The response will have the completed W-9 information for the given Payee Reference corresponding to the BusinessId. In addition, the Response Payload will also have the PdfUrl link to download the W-9.

{
"SubmissionId": "4a36dc14-f059-4c89-83cd-ff9e350ed0a0",
"Requester": {
"BusinessId": "7746f0cd-e8eb-4428-9240-12ea84160ee8",
"BusinessNm": "ABC LLC",
"TINType": "EIN",
"TIN": "22-2222222"
},
"PayeeRef": "Pe123451234",
"RecipientId":"775acc48-7492-487b-8edc-6c4d9877136f",
"W9Status": "COMPLETED_AND_TIN_MATCH_INPROGRESS",
"StatusTs": "2021-02-19 14:36:28 -05:00",
"TINMatching": {
"Status": "ORDER_CREATED",
"StatusTs": "2021-06-10 07:16:01 -04:00",
"Errors": null
},
"FormW9RequestType": "URL_API",
"PdfUrl": "https://taxbandits-sb-api.s3.amazonaws.com/sample/807f0318-7f5a-4841-9c08-a88b4bf7e7d9.pdf",
"Email": "sample@bodeem.com",
"FormData": {
"Line1Nm": "ABC Inc",
"Line2Nm": null,
"TINType": "EIN",
"TIN": "11-1111111",
"Address": {
"Address1": "123 E. Main St",
"Address2": "Suite 400",
"City": "Rock Hill",
"State": "SC",
"ZipCd": "29730"
},
"FederalTaxClassification": "C Corporation",
"ExemptPayeeCd": "5",
"ExemptFromFATCA": "E"
},
"Errors": null
}