[BETA] Document Method POST

The DOCUMENT method allows a company to retrieve documents used in the consent/authorization process. Any form sumbitted to the IRS by TaxStatus can be retrived with this method. These include:

  • IRS 8821 - filled out and signed authorization form, if used to get IRS authorization
  • IRS 4506c - filled out and signed authorization form, if used to get IRS authorization
  • US Drivers license/passport - if you had TaxStatus perform KYC during the signing process
  • Consent language - the language presented to and agreed by the taxpayer during the consent process

Request Path

Submit all document requests to the following path.


You will obtain the API endpoint after you register on your account page.


Each request must an OAuth2 tokan and your company Id, assigned by TaxStatus, in the header.


Query String Parameters

Query string parameters are not supported on this method.

/Document Request application/json

Post the following payload to retrieve the document in the request body.


  • companyId* The company Id of the company this call is on behalf of. If the call is not on behalf of another company, then the registered company Id TaxStatus assigned during the registration process used in the euid field in the header.
  • tin* 9-digit tax id (no spaces or hypens) of the individual or company
  • lastNameOrBusiness* The last name of the taxpayer or business name if business
  • isCompany* Booliean value indicating if this call is for an individual or business
  • docId* Id indicating which document to retrieve. This Id can be obtained either from the consent completed callback (if you are using callbacks). Or the response of the TAXPAYERS call, in the ConsentLink field, the value of req on the querystring. If the latter, you will need to append it to the document type. There are 3 different types of documents:
    • Identity - Driver's licenses or passports. Document type: Id
    • Authorization - The IRS form used in the authorization process. Document type: either 8821 or 4506
    • Consent - Terms the taxpayer agreed to. Document type: Consent

Example request body for the documnet method to retrieve a driver's license

{ "companyId": "RQV702VI5GC", "tin":"222222222", "lastNameOrBusiness":"Smith", "isCompany": false, "docId":"Id-Yuheg83H6D" }

Response Body application/json


  • Last4 The last 4 figits of the Tax Identification Number sent in the request
  • LastNameOrBusiness The last name or business name of the taxpayer
  • DocId The document Id sent in the request
  • Doc The document in base-64 string format

Example response body for the documant method

{ "Last4":"5647", "LastNameOrBusiness":"Jones", "DocId":"Id-Yuheg83H6D";, "Doc":"Base-64 string of file" }

The reponse codes for the document call are standard HTML response codes.

Response Codes

HTTP Status Code Description Explanation
200 Accepted/OK The request has been accepted with no issues
400 Bad Request You are missing some required fields or the Json in the body is missing or malformed
403 Forbidden You do not have authorization to make this call. Possibly your comapany Id is invalid or you are calling on behalf of a company with which you dont have authority.