POST

Submit Form W-8BEN Tax Documentation

Submits IRS Form W-8BEN tax documentation data for an individual foreign enterprise account owner. Pass-through to TaxBit POST /v1/account-owners/{id}/tax-documentation-data/w-8ben. Note: This endpoint currently returns hardcoded mock responses for initial client integration.

Path Params

enterpriseId string required

The enterprise ID to get a token for

32 to 32 characters · matches ^[0-9a-zA-Z]{32}$

Body Params

object

Form W-8BEN submission payload matching TaxBit POST /v1/account-owners/{id}/tax-documentation-data/w-8ben.

irs_version string enum

Set to 2021_OCT when submitting the official IRS Form W-8BEN; omit for substitute form

2021_OCT
name string

Name of individual who is the beneficial owner
country string enum

Country identifier (ISO 3166-1 alpha-2 code, IRS-only code, or territory name per TaxBit specification).

ADAEAFAGAIALAMANAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZWXKFQIPDXHQDQJQKQOCLQWQWZAKROTIRIASHMORE AND CARTIER ISLANDSBURMACORAL SEA ISLANDSEAST TIMORMIDWAY ISLANDSNAVASSA ISLANDPARACEL ISLANDSSPRATLY ISLANDSSVALBARD
permanent_address object

Shared TaxBit address object used across W-9, W-8BEN, W-8BEN-E, and Self-Certification.
permanent_address object
- first_line string
  
  First line of the address
- second_line string
  
  Second line of the address
- city string
  
  City
- state_or_province string
  
  State or province (US state, Canada province, or other)
- postal_code string
  
  Postal code
- country string enum
  
  Country identifier (ISO 3166-1 alpha-2 code, IRS-only code, or territory name per TaxBit specification).
  
  ADAEAFAGAIALAMANAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZWXKFQIPDXHQDQJQKQOCLQWQWZAKROTIRIASHMORE AND CARTIER ISLANDSBURMACORAL SEA ISLANDSEAST TIMORMIDWAY ISLANDSNAVASSA ISLANDPARACEL ISLANDSSPRATLY ISLANDSSVALBARD
mailing_address object

Shared TaxBit address object used across W-9, W-8BEN, W-8BEN-E, and Self-Certification.
mailing_address object
- first_line string
  
  First line of the address
- second_line string
  
  Second line of the address
- city string
  
  City
- state_or_province string
  
  State or province (US state, Canada province, or other)
- postal_code string
  
  Postal code
- country string enum
  
  Country identifier (ISO 3166-1 alpha-2 code, IRS-only code, or territory name per TaxBit specification).
  
  ADAEAFAGAIALAMANAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZWXKFQIPDXHQDQJQKQOCLQWQWZAKROTIRIASHMORE AND CARTIER ISLANDSBURMACORAL SEA ISLANDSEAST TIMORMIDWAY ISLANDSNAVASSA ISLANDPARACEL ISLANDSSPRATLY ISLANDSSVALBARD
us_tin string

U.S. taxpayer identification number (SSN or ITIN), if required
ftin string

Foreign tax identifying number
date_of_birth string

Date of birth (YYYY-MM-DD)
reference_numbers string

Reference number(s)
ftin_not_legally_required boolean

Check if FTIN is not legally required
has_signed_and_certified boolean

Indicates that the beneficial owner has signed and certified the W-8BEN
signature_timestamp string

ISO 8601 timestamp when the form was signed
completed_for string enum

Whether the form was completed for the ACCOUNT_HOLDER or REGARDED_OWNER

ACCOUNT_HOLDERREGARDED_OWNER
treaty_claim_is_eligible boolean

Indicates whether the beneficial owner is claiming treaty benefits
treaty_claim_country string enum

Country identifier (ISO 3166-1 alpha-2 code, IRS-only code, or territory name per TaxBit specification).

ADAEAFAGAIALAMANAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZWXKFQIPDXHQDQJQKQOCLQWQWZAKROTIRIASHMORE AND CARTIER ISLANDSBURMACORAL SEA ISLANDSEAST TIMORMIDWAY ISLANDSNAVASSA ISLANDPARACEL ISLANDSSPRATLY ISLANDSSVALBARD
treaty_claim_i_certify_resident boolean

Certifies residency in the treaty country
treaty_claim_type_of_income string enum

Special rates and conditions: type of income

BUSINESS_PROFITSDIVIDENDSINTERESTOTHER_INCOMEROYALTIES_MOTION_PICTURE_AND_TVROYALTIES_OTHER
treaty_claim_rate_of_withholding string

Special rates and conditions: percentage rate of withholding
treaty_claim_article_paragraph string

Special rates and conditions: treaty article and paragraph
treaty_claim_has_additional_conditions boolean

Indicates whether additional conditions apply to the treaty claim
signature string

Electronic signature of the beneficial owner

Responses

201

Response Body

object

Response returned upon successful Form W-8BEN submission.

data object required

Form W-8BEN submission payload matching TaxBit POST /v1/account-owners/{id}/tax-documentation-data/w-8ben.
data object
- irs_version string enum
  
  Set to 2021_OCT when submitting the official IRS Form W-8BEN; omit for substitute form
  
  2021_OCT
- name string
  
  Name of individual who is the beneficial owner
- country string enum
  
  Country identifier (ISO 3166-1 alpha-2 code, IRS-only code, or territory name per TaxBit specification).
  
  ADAEAFAGAIALAMANAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZWXKFQIPDXHQDQJQKQOCLQWQWZAKROTIRIASHMORE AND CARTIER ISLANDSBURMACORAL SEA ISLANDSEAST TIMORMIDWAY ISLANDSNAVASSA ISLANDPARACEL ISLANDSSPRATLY ISLANDSSVALBARD
- permanent_address object
  
  Shared TaxBit address object used across W-9, W-8BEN, W-8BEN-E, and Self-Certification.
  permanent_address object
  - first_line string
    
    First line of the address
  - second_line string
    
    Second line of the address
  - city string
    
    City
  - state_or_province string
    
    State or province (US state, Canada province, or other)
  - postal_code string
    
    Postal code
  - country string enum
    
    Country identifier (ISO 3166-1 alpha-2 code, IRS-only code, or territory name per TaxBit specification).
    
    ADAEAFAGAIALAMANAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZWXKFQIPDXHQDQJQKQOCLQWQWZAKROTIRIASHMORE AND CARTIER ISLANDSBURMACORAL SEA ISLANDSEAST TIMORMIDWAY ISLANDSNAVASSA ISLANDPARACEL ISLANDSSPRATLY ISLANDSSVALBARD
- mailing_address object
  
  Shared TaxBit address object used across W-9, W-8BEN, W-8BEN-E, and Self-Certification.
  mailing_address object
  - Same shape as TaxbitAddress.
- us_tin string
  
  U.S. taxpayer identification number (SSN or ITIN), if required
- ftin string
  
  Foreign tax identifying number
- date_of_birth string
  
  Date of birth (YYYY-MM-DD)
- reference_numbers string
  
  Reference number(s)
- ftin_not_legally_required boolean
  
  Check if FTIN is not legally required
- has_signed_and_certified boolean
  
  Indicates that the beneficial owner has signed and certified the W-8BEN
- signature_timestamp string
  
  ISO 8601 timestamp when the form was signed
- completed_for string enum
  
  Whether the form was completed for the ACCOUNT_HOLDER or REGARDED_OWNER
  
  ACCOUNT_HOLDERREGARDED_OWNER
- treaty_claim_is_eligible boolean
  
  Indicates whether the beneficial owner is claiming treaty benefits
- treaty_claim_country string enum
  
  Country identifier (ISO 3166-1 alpha-2 code, IRS-only code, or territory name per TaxBit specification).
  
  ADAEAFAGAIALAMANAOAQARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTHUIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSESGSHSISJSKSLSMSNSOSRSSSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYEYTZAZMZWXKFQIPDXHQDQJQKQOCLQWQWZAKROTIRIASHMORE AND CARTIER ISLANDSBURMACORAL SEA ISLANDSEAST TIMORMIDWAY ISLANDSNAVASSA ISLANDPARACEL ISLANDSSPRATLY ISLANDSSVALBARD
- treaty_claim_i_certify_resident boolean
  
  Certifies residency in the treaty country
- treaty_claim_type_of_income string enum
  
  Special rates and conditions: type of income
  
  BUSINESS_PROFITSDIVIDENDSINTERESTOTHER_INCOMEROYALTIES_MOTION_PICTURE_AND_TVROYALTIES_OTHER
- treaty_claim_rate_of_withholding string
  
  Special rates and conditions: percentage rate of withholding
- treaty_claim_article_paragraph string
  
  Special rates and conditions: treaty article and paragraph
- treaty_claim_has_additional_conditions boolean
  
  Indicates whether additional conditions apply to the treaty claim
- signature string
  
  Electronic signature of the beneficial owner

400

Response Body

object

error string required

Error message describing the validation failure
message string required

Details of why the request was rejected
issues array of objects

Per-field validation failures when the request body fails schema validation
issues object
- <key> object

401

Response Body

object

error string

Error name for the rejected request
message string required

Reason the request was rejected

403

Response Body

object

error string

Error message when the caller lacks permission on the enterprise
message string

Explicit deny message

404

Response Body

object

error string required

Error message indicating the resource was not found
message string required

Which resource could not be found

409

Response Body

object

error string required

Error message indicating a tax form was already submitted for the current tax year
message string required

Details of the existing submission conflict

429

Response Body

object

error string required

Error code emitted when the caller exceeds the rate limit
message string required

How long to wait before retrying

500

Response Body

object

error string required

Language

Credentials

Bearer

Request

curl -X POST \
     --url 'https://app.bitgo-test.com/api/identity-service/v1/taxbit/account/enterpriseId/tax-documentation-data/w-8ben' \
     --header 'accept: application/json' \
     --header 'Authorization: Bearer YOUR_ACCESS_TOKEN' \
     --header 'content-type: application/json' \
     --data '{,
       "irs_version": "2021_OCT",
       "name": "Jane Doe",
       "country": "US",
       "permanent_address": {,
         "first_line": "123 Pine St",
         "second_line": "Apt 456",
         "city": "Seattle",
         "state_or_province": "WA",
         "postal_code": "98000",
         "country": "US"
       },
       "mailing_address": {,
         "first_line": "123 Pine St",
         "second_line": "Apt 456",
         "city": "Seattle",
         "state_or_province": "WA",
         "postal_code": "98000",
         "country": "US"
       },
       "us_tin": "string",
       "ftin": "string",
       "date_of_birth": "string",
       "reference_numbers": "string",
       "ftin_not_legally_required": true,
       "has_signed_and_certified": true,
       "signature_timestamp": "string",
       "completed_for": "ACCOUNT_HOLDER",
       "treaty_claim_is_eligible": true,
       "treaty_claim_country": "US",
       "treaty_claim_i_certify_resident": true,
       "treaty_claim_type_of_income": "BUSINESS_PROFITS",
       "treaty_claim_rate_of_withholding": "string",
       "treaty_claim_article_paragraph": "string",
       "treaty_claim_has_additional_conditions": true,
       "signature": "Jane Doe"
     }'

Request

const url = 'https://app.bitgo-test.com/api/identity-service/v1/taxbit/account/enterpriseId/tax-documentation-data/w-8ben';
const options = {
  method: 'POST',
  headers: {accept: 'application/json', 'Authorization': 'Bearer YOUR_ACCESS_TOKEN', 'content-type': 'application/json'},
  body: JSON.stringify({,
    "irs_version": "2021_OCT",
    "name": "Jane Doe",
    "country": "US",
    "permanent_address": {,
      "first_line": "123 Pine St",
      "second_line": "Apt 456",
      "city": "Seattle",
      "state_or_province": "WA",
      "postal_code": "98000",
      "country": "US"
    },
    "mailing_address": {,
      "first_line": "123 Pine St",
      "second_line": "Apt 456",
      "city": "Seattle",
      "state_or_province": "WA",
      "postal_code": "98000",
      "country": "US"
    },
    "us_tin": "string",
    "ftin": "string",
    "date_of_birth": "string",
    "reference_numbers": "string",
    "ftin_not_legally_required": true,
    "has_signed_and_certified": true,
    "signature_timestamp": "string",
    "completed_for": "ACCOUNT_HOLDER",
    "treaty_claim_is_eligible": true,
    "treaty_claim_country": "US",
    "treaty_claim_i_certify_resident": true,
    "treaty_claim_type_of_income": "BUSINESS_PROFITS",
    "treaty_claim_rate_of_withholding": "string",
    "treaty_claim_article_paragraph": "string",
    "treaty_claim_has_additional_conditions": true,
    "signature": "Jane Doe"
  })
};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

Request

require 'uri'
require 'net/http'

url = URI("https://app.bitgo-test.com/api/identity-service/v1/taxbit/account/enterpriseId/tax-documentation-data/w-8ben")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["accept"] = 'application/json'
request["Authorization"] = 'Bearer YOUR_ACCESS_TOKEN'
request["content-type"] = 'application/json'
request.body = '{,
  "irs_version": "2021_OCT",
  "name": "Jane Doe",
  "country": "US",
  "permanent_address": {,
    "first_line": "123 Pine St",
    "second_line": "Apt 456",
    "city": "Seattle",
    "state_or_province": "WA",
    "postal_code": "98000",
    "country": "US"
  },
  "mailing_address": {,
    "first_line": "123 Pine St",
    "second_line": "Apt 456",
    "city": "Seattle",
    "state_or_province": "WA",
    "postal_code": "98000",
    "country": "US"
  },
  "us_tin": "string",
  "ftin": "string",
  "date_of_birth": "string",
  "reference_numbers": "string",
  "ftin_not_legally_required": true,
  "has_signed_and_certified": true,
  "signature_timestamp": "string",
  "completed_for": "ACCOUNT_HOLDER",
  "treaty_claim_is_eligible": true,
  "treaty_claim_country": "US",
  "treaty_claim_i_certify_resident": true,
  "treaty_claim_type_of_income": "BUSINESS_PROFITS",
  "treaty_claim_rate_of_withholding": "string",
  "treaty_claim_article_paragraph": "string",
  "treaty_claim_has_additional_conditions": true,
  "signature": "Jane Doe"
}'

response = http.request(request)
puts response.read_body

Request

<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://app.bitgo-test.com/api/identity-service/v1/taxbit/account/enterpriseId/tax-documentation-data/w-8ben', [
  'headers' => [
    'accept' => 'application/json',
    'Authorization' => 'Bearer YOUR_ACCESS_TOKEN',
    'content-type' => 'application/json',
  ],
  'body' => '{,
    "irs_version": "2021_OCT",
    "name": "Jane Doe",
    "country": "US",
    "permanent_address": {,
      "first_line": "123 Pine St",
      "second_line": "Apt 456",
      "city": "Seattle",
      "state_or_province": "WA",
      "postal_code": "98000",
      "country": "US"
    },
    "mailing_address": {,
      "first_line": "123 Pine St",
      "second_line": "Apt 456",
      "city": "Seattle",
      "state_or_province": "WA",
      "postal_code": "98000",
      "country": "US"
    },
    "us_tin": "string",
    "ftin": "string",
    "date_of_birth": "string",
    "reference_numbers": "string",
    "ftin_not_legally_required": true,
    "has_signed_and_certified": true,
    "signature_timestamp": "string",
    "completed_for": "ACCOUNT_HOLDER",
    "treaty_claim_is_eligible": true,
    "treaty_claim_country": "US",
    "treaty_claim_i_certify_resident": true,
    "treaty_claim_type_of_income": "BUSINESS_PROFITS",
    "treaty_claim_rate_of_withholding": "string",
    "treaty_claim_article_paragraph": "string",
    "treaty_claim_has_additional_conditions": true,
    "signature": "Jane Doe"
  }',
]);

echo $response->getBody();

Request

import requests

url = "https://app.bitgo-test.com/api/identity-service/v1/taxbit/account/enterpriseId/tax-documentation-data/w-8ben"

payload = {,
  "irs_version": "2021_OCT",
  "name": "Jane Doe",
  "country": "US",
  "permanent_address": {,
    "first_line": "123 Pine St",
    "second_line": "Apt 456",
    "city": "Seattle",
    "state_or_province": "WA",
    "postal_code": "98000",
    "country": "US"
  },
  "mailing_address": {,
    "first_line": "123 Pine St",
    "second_line": "Apt 456",
    "city": "Seattle",
    "state_or_province": "WA",
    "postal_code": "98000",
    "country": "US"
  },
  "us_tin": "string",
  "ftin": "string",
  "date_of_birth": "string",
  "reference_numbers": "string",
  "ftin_not_legally_required": true,
  "has_signed_and_certified": true,
  "signature_timestamp": "string",
  "completed_for": "ACCOUNT_HOLDER",
  "treaty_claim_is_eligible": true,
  "treaty_claim_country": "US",
  "treaty_claim_i_certify_resident": true,
  "treaty_claim_type_of_income": "BUSINESS_PROFITS",
  "treaty_claim_rate_of_withholding": "string",
  "treaty_claim_article_paragraph": "string",
  "treaty_claim_has_additional_conditions": true,
  "signature": "Jane Doe"
}
headers = {
    "accept": "application/json",
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

Response

{
  "data": {
    "irs_version": "2021_OCT",
    "name": "Jane Doe",
    "country": "US",
    "permanent_address": {
      "first_line": "123 Pine St",
      "second_line": "Apt 456",
      "city": "Seattle",
      "state_or_province": "WA",
      "postal_code": "98000",
      "country": "US"
    },
    "mailing_address": {
      "first_line": "123 Pine St",
      "second_line": "Apt 456",
      "city": "Seattle",
      "state_or_province": "WA",
      "postal_code": "98000",
      "country": "US"
    },
    "us_tin": "string",
    "ftin": "string",
    "date_of_birth": "1985-06-15T00:00:00Z",
    "reference_numbers": "string",
    "ftin_not_legally_required": true,
    "has_signed_and_certified": true,
    "signature_timestamp": "2026-01-15T12:00:00Z",
    "completed_for": "ACCOUNT_HOLDER",
    "treaty_claim_is_eligible": true,
    "treaty_claim_country": "US",
    "treaty_claim_i_certify_resident": true,
    "treaty_claim_type_of_income": "BUSINESS_PROFITS",
    "treaty_claim_rate_of_withholding": "string",
    "treaty_claim_article_paragraph": "string",
    "treaty_claim_has_additional_conditions": true,
    "signature": "Jane Doe"
  }
}

{
  "error": "Bad Request",
  "message": "Invalid request",
  "issues": [
    {
      "key": "string"
    }
  ]
}

{
  "error": "Unauthorized",
  "message": "Unauthorized Error"
}

{
  "error": "Forbidden",
  "message": "User does not have admin permission on enterprise"
}

{
  "error": "Not Found",
  "message": "Object with id Account1234 cannot be found"
}

{
  "error": "Conflict",
  "message": "Tax documentation for this form category has already been submitted for the current tax year"
}

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded. Please retry after 30 seconds."
}

{
  "error": "string"
}