# Generate Tax Documents

Source: https://developers.bitgo.com/docs/crypto-as-a-service-tax-documents

## Overview

Generate year-end tax documents for your end users. Your application presents legal disclosure and eDelivery consent language, collects the required end-user tax information, submits the completed documentation to BitGo, and retrieves the resulting data for tax-document generation.

The integration workflow supports collecting Form W-9, Form W-8BEN, Form W-8BEN-E, and DAC8 self-certification information. The document type depends on the end user's tax residency, entity type, and applicable reporting requirements. Your application remains responsible for presenting the forms and disclosures to the end user, collecting accurate information, and handling sensitive tax data securely.

After the required documentation is accepted, BitGo generates an IRS Form 1099 for the end user. You then download the document and make it available to your end users.

## Prerequisites

[Get Started](/docs/get-started-intro)

## 1. Get Legal Disclosure and Agreement

Get the latest text and version number of the legal disclosure and agreement for tax document eDelivery. You must share this with your end users in your application before submitting your their consent and attestation to BitGo.

> Endpoint: [Get legal disclosure and agreement](/reference/documentsgetv1agreementsid)

```shell cURL (DAC8)
export AGREEMENT_ID="taxEDeliveryConsent"
export ACCESS_TOKEN="<SERVICE_USER_ACCESS_TOKEN>"

curl -X POST \
  https://app.bitgo-test.com/api/document-service/v1/agreements/$AGREEMENT_ID \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{
       "e_delivery_consent": true
     }'
```

#### Step Result

```json JSON
{
  "agreementId": "taxEDeliveryConsent",
  "revision": 0,
  "content": {
    "key": "string"
  }
}
```

## 2. Submit Documentation

Pass your end users' relevant tax documentation to BitGo:

* For custody with BitGo Bank and Trust, use W-8BEN, W-8BEN-, and W-9.
* For custody with BitGo Europe GmbH, use DAC8.

> Endpoints:
>
> * [Submit DAC8 Self-Certification Tax Documentation](/reference/identitiespostv1taxbitaccountidtaxdocumentationdataselfcertification)
> * [Submit Form W-8BEN Tax Documentation](/reference/identitiespostv1taxbitaccountidtaxdocumentationdataw8ben)
> * [Submit Form W-8BEN-E Tax Documentation](/reference/identitiespostv1taxbitaccountidtaxdocumentationdataw8bene)
> * [Submit Form W-9 Tax Documentation](/reference/identitiespostv1taxbitaccountidtaxdocumentationdataw9)

```shell cURL (DAC8)
export ENTERPRISE_ID="<END_USER_ENTERPRISE_ID>"
export ACCESS_TOKEN="<SERVICE_USER_ACCESS_TOKEN>"

curl -X POST \
  https://app.bitgo-test.com/api/identity-service/v1/taxbit/account/$ENTERPRISE_ID/tax-documentation-data/self-certification \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -d '{
       "e_delivery_consent": true
     }'
```
```shell cURL (W-8BEN)
export ENTERPRISE_ID="<END_USER_ENTERPRISE_ID>"
export ACCESS_TOKEN="<SERVICE_USER_ACCESS_TOKEN>"

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 $ACCESS_TOKEN" \
  -d '{
       "e_delivery_consent": true
     }'
```
```shell cURL (W-8BEN-E)
export ENTERPRISE_ID="<END_USER_ENTERPRISE_ID>"
export ACCESS_TOKEN="<SERVICE_USER_ACCESS_TOKEN>"

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 $ACCESS_TOKEN" \
  -d '{
       "e_delivery_consent": true
     }'
```
```shell cURL (W-9)
export ENTERPRISE_ID="<END_USER_ENTERPRISE_ID>"
export ACCESS_TOKEN="<SERVICE_USER_ACCESS_TOKEN>"

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 $ACCESS_TOKEN" \
  -d '{
       "e_delivery_consent": true
     }'
```

#### Step Result

BitGo returns the end users' data required region.

```json JSON (DAC8)
{
  "data": {
    "e_delivery_consent": true,
    "name": "Euro Crypto GmbH",
    "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"
    },
    "tax_residences": [
      {
        "country": "US",
        "tin": "string",
        "tin_not_required": true,
        "tin_not_required_reason": "NOT_ISSUED",
        "tin_not_required_reason_other": "string",
        "hashed_tin": "string"
      }
    ],
    "classification": "INDIVIDUAL",
    "signature_date": "2026-01-15T00:00:00Z",
    "has_signed_and_certified": true,
    "date_of_birth": "string",
    "city_of_birth": "string",
    "country_of_birth": "US",
    "country_of_citizenship": "US",
    "entity_type": "TRUST",
    "securities_market": "string",
    "related_corporation": "string",
    "controlling_persons": [
      {
        "name": "string",
        "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"
        },
        "mailing_address_is_different": true,
        "date_of_birth": "string",
        "city_of_birth": "string",
        "country_of_birth": "US",
        "country_of_citizenship": "US",
        "ownership_percentage": 0,
        "residence_by_investment_confirmed": true,
        "role": "SETTLOR",
        "role_other": "string",
        "role_other_equivalent": "string",
        "tax_residences": [
          {
            "country": "US",
            "tin": "string",
            "tin_not_required": true,
            "tin_not_required_reason": "NOT_ISSUED",
            "tin_not_required_reason_other": "string",
            "hashed_tin": "string"
          }
        ]
      }
    ],
    "signature_capacity": "OFFICER",
    "signature_capacity_other": "string",
    "giin": "string",
    "residence_by_investment_confirmed": true,
    "signature": "Hans Mueller",
    "active_non_financial_entity_type": "OTHER",
    "financial_institution_type": "DEPOSITORY_INSTITUTION",
    "investment_entity_managed": true,
    "is_individual": true,
    "self_certification_account_type": "FINANCIAL_INSTITUTION"
  }
}
```
```json JSON (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"
  }
}
```
```json JSON (W-8BEN-E)
{
  "data": {
    "e_delivery_consent": true,
    "irs_version": "2021_OCT",
    "name": "Global Digital Assets Ltd",
    "country": "US",
    "tax_classification": "CORPORATION",
    "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",
    "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,
    "treaty_claim_i_certify_requirements": true,
    "treaty_claim_limitation_on_benefits": "GOVERNMENT",
    "treaty_claim_limitation_on_benefits_other_article_paragraph": "string",
    "fatca_classification": "ACCOUNT_NOT_FINANCIAL",
    "giin": "string",
    "giin_applied_for": true,
    "sponsoring_entity_or_trustee_name": "string",
    "nonreporting_iga_country": "AE",
    "nonreporting_iga_country_model": "MODEL_1",
    "nonreporting_iga_category": "ARTICLE_XXI_ENTITIES",
    "nonreporting_iga_trustee_type": "FOREIGN",
    "securities_market": "string",
    "affiliate_entity_name": "string",
    "substantial_us_owners": [
      {
        "name": "John Doe",
        "address": {
          "first_line": "123 Pine St",
          "second_line": "Apt 456",
          "city": "Seattle",
          "state_or_province": "WA",
          "postal_code": "98000",
          "country": "US"
        },
        "us_tin": "123456789"
      }
    ],
    "box_17_1": true,
    "box_17_2": true,
    "box_18": true,
    "box_19": true,
    "box_21": true,
    "box_22": true,
    "box_23": true,
    "box_24a": true,
    "box_24b": true,
    "box_24c": true,
    "box_24d": true,
    "box_25a": true,
    "box_25b": true,
    "box_25c": true,
    "box_26": true,
    "box_27": true,
    "box_28a": true,
    "box_28b": true,
    "box_29a": true,
    "box_29b": true,
    "box_29c": true,
    "box_29d": true,
    "box_29e": true,
    "box_29f": true,
    "box_30": true,
    "box_31": true,
    "box_32": true,
    "box_33": true,
    "box_33_date_of_formation": "string",
    "box_34": true,
    "box_34_date_of_filing": "string",
    "box_35": true,
    "box_35_determination_letter_date": "string",
    "box_36": true,
    "box_37a": true,
    "box_37b": true,
    "box_38": true,
    "box_39": true,
    "box_40a": true,
    "box_40b": true,
    "box_40c": true,
    "box_41": true,
    "box_43": true,
    "signature": "Alex Smith"
  }
}
```
```json JSON (W-9)
{
  "data": {
    "e_delivery_consent": true,
    "name": "John Doe",
    "dba_name": "Acme LLC",
    "tax_classification": "INDIVIDUAL",
    "other_tax_classification": "string",
    "address": {
      "first_line": "123 Pine St",
      "second_line": "Apt 456",
      "city": "Seattle",
      "state_or_province": "WA",
      "postal_code": "98000",
      "country": "US"
    },
    "tin": "123456789",
    "tin_type": "SSN",
    "exempt_payee_code": "1",
    "exempt_fatca_code": "A",
    "is_not_subject_backup_withholding": true,
    "has_signed_and_certified": true,
    "signature_timestamp": "2026-01-15T12:00:00Z",
    "completed_for": "ACCOUNT_HOLDER",
    "signature": "John Doe"
  }
}
```

## Next

BitGo generates an IRS form 1099 for the end user that you can download and share with them.

## See Also

* [API Reference: Get legal disclosure and agreement](/reference/documentsgetv1agreementsid)
* [API Reference: Get Tax Documentation Data](/reference/identitiesgetv1taxbitaccountidtaxdocumentationdata)
* [API Reference: Submit DAC8 Self-Certification Tax Documentation](/reference/identitiespostv1taxbitaccountidtaxdocumentationdataselfcertification)
* [API Reference: Submit Form W-8BEN Tax Documentation](/reference/identitiespostv1taxbitaccountidtaxdocumentationdataw8ben)
* [API Reference: Submit Form W-8BEN-E Tax Documentation](/reference/identitiespostv1taxbitaccountidtaxdocumentationdataw8bene)
* [API Reference: Submit Form W-9 Tax Documentation](/reference/identitiespostv1taxbitaccountidtaxdocumentationdataw9)
