Generate Tax Documents

Collect tax documentation and retrieve data for end-user tax documents. See the Guide.

  1. Retrieve the latest legal disclosure and agreement text. Present it to your end users in your application before obtaining their consent and attestation. You must have completed Get Started before beginning this workflow.

    API Reference

  2. Collect the appropriate Form W-8BEN, Form W-8BEN-E, or Form W-9 information from your end user and submit it to BitGo. Select the document type based on the end user's tax residency, entity type, and applicable reporting requirements. Protect sensitive tax information and do not log complete request bodies or responses in production.

    API Reference API Reference API Reference

// 1. Get Legal Disclosure and Agreement
export AGREEMENT_ID="taxEDeliveryConsent"
export SERVICE_USER_TOKEN="<YOUR_SERVICE_USER_ACCESS_TOKEN>"

curl -X POST \
  https://app.bitgo-test.com/api/identity-service/v1/agreements/$AGREEMENT_ID \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
       "e_delivery_consent": true
     }'
// 2. Submit Documentation
export ENTERPRISE_ID="<YOUR_END_USER_ENTERPRISE_ID>"

# W-8BEN
curl -X POST \
  https://app.bitgo-test.com/api/identity-service/v1/taxbit/account/$ENTERPRISE_ID/tax-documentation-data/w-8ben \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
       "e_delivery_consent": true
     }'

# W-8BEN-E
curl -X POST \
  https://app.bitgo-test.com/api/identity-service/v1/taxbit/account/$ENTERPRISE_ID/tax-documentation-data/w-8ben-e \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
       "e_delivery_consent": true
     }'

# W-9
curl -X POST \
  https://app.bitgo-test.com/api/identity-service/v1/taxbit/account/$ENTERPRISE_ID/tax-documentation-data/w-9 \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $SERVICE_USER_TOKEN" \
  -d '{
Response
// 1. Get Legal Disclosure and Agreement Response
{
  "agreementId": "taxEDeliveryConsent",
  "revision": 0,
  "content": {
    "key": "string"
  }
}

// 2. Submit Documentation Response (W-8BEN)
{
  "data": {
    "e_delivery_consent": true,
    "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"
  }
}