Create
If you already have completed W-9 or W-8 forms (or their data) for your recipients, you can use this manual save endpoint to upload that information directly to the TaxBandits system.
Upon a successful request, the recipients will be created under the specified business, and a new RecipientId will be assigned for each recipient affiliated with that business.
POST WhCertificate/Create 
Request Body
| Field | Type | Description |
|---|---|---|
| FormType | string | Withholding certificate form type Allowed values |
| IsTinMatching | Boolean | Optional TIN Matching will be enabled when the value is set as True. Once the recipient completes Form W-9, TaxBandits will match the Recipient's Name and SSN with the IRS database and notify the client via the webhook with the TIN results. |
| PdfUrl | string | Pdf URL of the completed W9/W8 form |
| Requester | object | Requester Details |
| BusinessId | Guid | Optional Use the unique Business ID (Generated by TaxBandits), you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again. |
| PayerRef | string | Optional An unique identifier for each payer completing their information. This identifier can be used in future references of the payer in the API. Size Range: ..50 |
| TINType | string | Optional TIN Type of the Requester. Allowed values |
| TIN | string | Optional Taxpayer Identification Number. Use this as an alternate for BusinessId. Size Range: 9-11 |
| PayeeRef | String | Optional A unique identifier for each recipient completing the Form W-9 for future references. Size Range: 1-50 |
| string | Email Address of the recipient. This is the email address to which the W-9 request email will be sent. Size Range: ..100 | |
| FormW9 | Object | Form W-9 data of the recipient |
| Line1Nm | string | Name as shown on the income tax return Size Range: 40 |
| Line2Nm | string | Business name/disregarded entity name, if different from Line 1 Name Size Range: 40 |
| FirstNm | string | First Name of the Individual Size Range: 20 |
| MiddleNm | string | Middle Name of the Individual Size Range: 20 |
| LastNm | string | Last Name of the individual Size Range: 20 |
| Suffix | string | Suffix of the IndividualAllowed values |
| TINType | string | TIN type of the recipient.Allowed values |
| TIN | string | Recipient's TIN Size Range:9-11 |
| Address | Object | Recipient's complete address |
| Address1 | string | Recipient's Address 1 (number, street) Size Range:46 |
| Address2 | string | Recipient's Address 2 (apt. or suite no.) Size Range:46 |
| City | string | Recipient's City Size Range:50 |
| State | string | Recipient's State Size Range:2 |
| ZipCd | string | Recipient's Zip Code Size Range:5..10 |
| AccountNum | string | Recipient's account number. You can use this field to enter any identification number you have for the recipient. Size Range:50 |
| FederalTaxClassification | string | U.S. Federal Tax Classification of the person whose name is entered on Line 1Allowed values |
| OtherDesc | string | U.S. Federal Tax Classification of the individual or entity on Line 1, when 'Other' is selected as the Federal Tax Classification. Size Range: 50 |
| IsLine3b | Boolean | If TRUE, identifies that the recipient is Either a partnership, trust or estate that has foreign partners, owners, or beneficiaries and the recipient is providing this form to a partnership, trust, or estate, in which they have an ownership interest. (or) Received a Form W-8 from any partner, owner, or beneficiary establishing foreign status (or) Received a Form W-9 from any partner, owner, or beneficiary that has checked the box on line 3b. |
| ExemptPayeeCd | string | This code identifies the recipient is exempt from backup withholdingAllowed values |
| ExemptFromFATCA | string | This code identifies recipients that are exempt from reporting under FATCA.Allowed values |
| IsBackUpWH | Boolean | When true, identifies the recipient is subject to backup withholding. (The completed Form W-9 PDF will have the item 2 under Part II crossed out.) When false, identifies the recipient is not subject to backup withholding. |
| FormW8Ben | Object | Form W-8BEN Information. |
| NmOfIndividual | string | Name of the Foreign Individual. Size Range : 60 |
| FirstNm | string | First Name of the Individual Size Range: 20 |
| MiddleNm | string | Middle Name of the Individual Size Range: 20 |
| LastNm | string | Last Name of the individual Size Range: 20 |
| Suffix | string | Suffix of the Individual Allowed values |
| CitizenOfCountry | string | Recipient country of citizenship.Allowed values |
| USTINType | string | TIN type of the recipient.Allowed values |
| USTIN | string | Recipient's TIN Size Range: 9 |
| ForeignTIN | string | Foreign TIN of the recipient. Size Range: 25 |
| IsFTINNotLegallyRequired | Boolean | When true, Identifies that beneficial owner on line 1 is not legally required to obtain an FTIN from their jurisdiction of residence. |
| ReferenceNum | string | Recipient's reference number. You can use this field to enter any identification number you have for the recipient. Size Range: 50 |
| DOB | string | Date of Birth of the recipient Allowed format: MM-DD-YYYY or MM/DD/YYYY |
| ExpiryDate | string | Date of form expiration. Allowed format: MM-DD-YYYY or MM/DD/YYYY |
| PermanentAddress | Object | Recipient's permanent address. |
| Address1 | string | Recipient's Address. Size Range: 50 |
| Address2 | string | Optional Recipient's suite or apartment Size Range: 50 |
| City | string | Recipient's City Size Range: 50 |
| State | string | Recipient's State Size Range: 50 |
| Country | string | Recipient's Country Allowed values |
| PostalCd | string | Recipient's Zip Code Size Range: 16 |
| MailingAddress | Object | Recipient's mailing address. |
| Address1 | string | Recipient's Address. Size Range: 50 |
| Address2 | string | Optional Recipient's suite or apartment Size Range: 50 |
| City | string | Recipient's City Size Range: 50 |
| State | string | Recipient's State Size Range: 50 |
| Country | string | Recipient's CountryAllowed values |
| PostalCd | string | Recipient's Zip Code Size Range: 16 |
| W8TaxBenefits | Object | Tax Treaty Benefits. |
| BeneficiaryCountry | string | Country where the recipient claim to be a resident for income tax treaty purposes.Allowed values |
| ClaimingProvArticlePara | string | Article and paragraph of the treaty benefits. Size Range: 25 |
| RateOfWH | string | Rate of Withholding. Size Range: 5 |
| TypeOfIncome | string | Type of income for which recipient claims the treaty benefits.Allowed values |
| AdditionalConditions | string | Additional conditions from the tax treaty benefits. Size Range: 40 |
| Signature | Object | Signature of the recipient. |
| SignerNm | string | Name of the signer. Size Range: 65 |
| FormW8BenE | Object | Form W-8BENE data of the recipient |
| Part1 | Object | Beneficial Owner Information |
| NmOfOrganization | string | Name of the Organization. Size Range: 40 |
| CountryOfOrganization | string | Country of the Organization.Allowed values |
| NmOfDisregardedEntity | string | Business name/disregarded entity name, if different from Organization's name Size Range: 80 |
| Ch3Status | string | The entity's Chapter 3 status for withholding purposes under U.S. tax law.Allowed values |
| IsEntityTreatyClaim | boolean | When true, identifies that the entity is a hybrid making a treaty claim Note: Applicable only if the Chapter 3 status is Disregarded Entity, Partnership, Simple Trust, or Grantor Trust |
| Ch4Status | string | The entity's Chapter 4 status for withholding purposes under U.S. tax law.Allowed values |
| USTINType | string | TIN type of the recipient.Allowed values |
| USTIN | string | Recipient's TIN Size Range: 9-11 |
| GIIN | string | Entity's GIIN Size Range: 19 |
| ForeignTIN | string | Foreign TIN of the recipient. Size Range: 25 |
| IsFTINNotLegallyRequired | Boolean | When true, identifies that beneficial owner on line 1 is not legally required to obtain an FTIN from their jurisdiction of residence. |
| ReferenceNum | string | Recipient's reference number. You can use this field to enter any identification number you have for the recipient. Size Range: 50 |
| ExpiryDate | string | Date of form W-8BEN-E expiration Allowed format: MM/DD/YYYY or MM-DD-YYYY |
| PermanentAdd | Object | Recipient's permanent address. |
| Address1 | string | Recipient's Address 1 (number, street) Size Range: ..46 |
| Address2 | string | Optional Recipient's Address 2 (apt. or suite no.) Size Range: ..46 |
| City | string | Recipient's City Size Range: ..50 |
| State | string | Recipient's State Size Range: ..50 |
| Country | string | Recipient's Country Size Range: ..2 Allowed values |
| PostalCd | string | Postal Code the State where the Employer/Payer is based out of Size Range:..16 |
| MailAdd | Object | Recipient's mailing address. |
| Address1 | string | Recipient's Address 1 (number, street) Size Range: ..46 |
| Address2 | string | Optional Recipient's Address 2 (apt. or suite no.) Size Range: ..46 |
| City | string | Recipient's City Size Range: ..50 |
| State | string | Recipient's State Size Range: ..50 |
| Country | string | Recipient's Country Size Range: ..2 Allowed values |
| PostalCd | string | Postal Code the State where the Employer/Payer is based out of Size Range:..16 |
| Part2 | Object | Disregarded Entity or Branch Receiving Payment information |
| Ch4StatusOfDisregardedEntity | string | Chapter 4 Status (FATCA status) of disregarded entity or branch receiving paymentAllowed values |
| AddOfDisregardedEntity | object | Disregarded entity's address |
| Address1 | string | Disregarded Entity's Address 1 Size Range: ..46 |
| Address2 | string | Optional Disregarded Entity's Address 2 Size Range: ..46 |
| City | string | Disregarded Entity's City Size Range: ..50 |
| State | string | Disregarded Entity's State Size Range: ..60 |
| Country | string | Disregarded Entity's Country Size Range: ..2 |
| PostalCd | string | Disregarded Entity's ZipCode Size Range: ..10 |
| GIIN | string | Entity's GIIN Size Range: 19 |
| Part3 | Object | Tax treaty information |
| IsBeneficiaryCountryTreatedWithin | Boolean | When true, identifies the beneficial owner as a resident of a country with which the United States has an income tax treaty. |
| BeneficiaryCountry | string | Country where the recipient claims to be a resident for income tax treaty purposes.Allowed values |
| IsBeneficiaryClaimingTreatyBenefits | Boolean | When true, identifies that the beneficial owner is claiming treaty benefits for US source of dividends received from a foreign corporation or interest from a U.S. trade or business of a foreign corporation and meets qualified resident status |
| LimitationOnBenefits | string | Type of limitation on benefits provisions that are included in an applicable tax treatyAllowed values |
| OtherDetail | string | Other limitation on benefits provisions information (Article and Paragraph) Size Range: 35 |
| IsBenifitsForUSSourceFromForeignCorp | Boolean | When true, Identifies the beneficial owner is claiming treaty benefits for U.S. source dividends received from a foreign corporation or interest from a U.S. trade or business of a foreign corporation and meets qualified resident status |
| ClaimingProvArticlePara | string | Article and paragraph of the treaty benefits. Size Range: 25 |
| RateOfWH | string | Rate of Withholding. Size Range: 5 |
| TypeOfIncome | string | Type of income for which recipient claims the treaty benefits.Allowed values |
| AdditionalConditions | string | Additional conditions from the tax treaty benefits. Size Range: 40 |
| Part4 | Object | Sponsored FFI information |
| NmOfSponsoringEntity | string | Name of the sponsoring entity Size Range: 80 |
| Line17Box1 | Boolean | When true, Identifies the entity in Part I:
|
| Line17Box2 | Boolean | when true, Identifies the entity in the Part I:
|
| Part5 | Object | Certified deemed-compliant nonregistering local bank information |
| Line18 | Boolean | When true, identifies the FFI in Part I:
|
| Part6 | Object | Certified deemed-compliant FFI with only low-value accounts information |
| Line19 | Boolean | When true,identifies the FFI in Part I:
|
| Part7 | Object | Certified deemed-sponsored, closely held investment vehicle information |
| NmOfSponsoringEntity | string | Name of the sponsoring entity Size Range:80 |
| Line21 | Boolean | When true, identifies that the entity in Part I:
|
| Part8 | Object | Certified deemed-compliant limited life debt investment entity information |
| Line22 | Boolean | When true, identifies the entity in Part I:
|
| Part9 | Object | Certain investment entities that do not maintain financial accounts information |
| Line23 | Boolean | When true, identifies the entity in Part I:
|
| Part10 | Object | Owner-Documented FFI information |
| Line24a | Boolean | When true, identifies the FFI in Part I: 1. Does not act as an intermediary; 2. Does not accept deposits in the ordinary course of a banking or similar business; 3. Does not hold, as a substantial portion of its business, financial assets for the account of others; 4. Is not an insurance company (or the holding company of an insurance company) that issues or is obligated to make payments with respect to a financial account; 5. Is not owned by or in an expanded affiliated group with an entity that accepts deposits in the ordinary course of a banking or similar business, holds, as a substantial portion of its business, financial assets for the account of others, or is an insurance company (or the holding company of an insurance company) that issues or is obligated to make payments with respect to a financial account; 6. Does not maintain a financial account for any nonparticipating FFI; and 7. Does not have any specified U.S. persons that own an equity interest or debt interest (other than a debt interest that is not a financial account or that has a balance or value not exceeding $50,000) in the FFI other than those identified on the FFI owner reporting statement. |
| Line24b | Boolean | When true, identifies the FFI identified in Part I: 1. Has provided, or will provide, an FFI owner reporting statement that contains: (i) The name, address, TIN (if any), chapter 4 status, and type of documentation provided (if required) of every individual and specified U.S. person that owns a direct or indirect equity interest in the owner- documented FFI (looking through all entities other than specified U.S. persons); (ii) The name, address, TIN (if any), and chapter 4 status of every individual and specified U.S. person that owns a debt interest in the owner-documented FFI (including any indirect debt interest, which includes debt interests in any entity that directly or indirectly owns the payee or any direct or indirect equity interest in a debt holder of the payee) that constitutes a financial account in excess of $50,000 (disregarding all such debt interests owned by participating FFIs, registered deemed-compliant FFIs, certified deemedcompliant FFIs, excepted NFFEs, exempt beneficial owners, or U.S. persons other than specified U.S. persons); and (iii) Any additional information the withholding agent requests in order to fulfill its obligations with respect to the entity. 2. Has provided, or will provide, valid documentation meeting the requirements of Regulations section 1.1471-3(d)(6)(iii) for each person identified in the FFI owner reporting statement. |
| Line24c | Boolean | When true, identifies that the FFi identified in Part I has provided, or will provide, an auditor's letter, signed within 4 years of the date of payment, from an independent accounting firm or legal representative with a location in the United States stating that the firm or representative has reviewed the FFI's documentation with respect to all of its owners and debt holders identified in Regulations section 1.1471-3(d)(6)(iv)(A)(2), and that the FFI meets all the requirements to be an owner-documented FFI. The FFI identified in Part I has also provided, or will provide, an FFI owner reporting statement of its owners that are specified U.S. persons and Form(s) W-9, with applicable waivers. |
| Line24d | Boolean | Optional When true, identifies the entity identified on line 1 is a trust that does not have any contingent beneficiaries or designated classes with unidentified beneficiaries |
| Part11 | Object | Restricted distributor information |
| Line25a | Boolean | When true, identifies the entity identified in Part I: 1. Operates as a distributor with respect to debt or equity interests of the restricted fund with respect to which this form is furnished; 2. Provides investment services to at least 30 customers unrelated to each other and less than half of its customers are related to each other; 3. Is required to perform AML due diligence procedures under the anti-money laundering laws of its country of organization (which is an FATFcompliant jurisdiction); 4. Operates solely in its country of incorporation or organization, has no fixed place of business outside of that country, and has the same country of incorporation or organization as all members of its affiliated group, if any; 5. Does not solicit customers outside its country of incorporation or organization; 6. Has no more than $175 million in total assets under management and no more than $7 million in gross revenue on its income statement for the most recent accounting year; 7. Is not a member of an expanded affiliated group that has more than $500 million in total assets under management or more than $20 million in gross revenue for its most recent accounting year on a combined or consolidated income statement; and 8. Does not distribute any debt or securities of the restricted fund to specified U.S. persons, passive NFFEs with one or more substantial U.S. owners, or nonparticipating FFIs. |
| Line25b | Boolean | When true, identifies the entity in Part I has been bound by a distribution agreement that contained a general prohibition on the sale of debt or securities to U.S. entities and U.S. resident individuals and is currently bound by a distribution agreement that contains a prohibition of the sale of debt or securities to any specified U.S. person, passive NFFE with one or more substantial U.S. owners, or nonparticipating FFI. |
| Line25c | Boolean | When true, identifies the entity in Part I is currently bound by a distribution agreement that contains a prohibition on the sale of debt or securities to any specified U.S. person, passive NFFE with one or more substantial U.S. owners, or nonparticipating FFI and, for all sales made prior to the time that such a restriction was included in its distribution agreement, has reviewed all accounts related to such sales in accordance with the procedures identified in Regulations section 1.1471-4(c) applicable to preexisting accounts and has redeemed or retired any, or caused the restricted fund to transfer the securities to a distributor that is a participating FFI or reporting Model 1 FFI securities which were sold to specified U.S. persons, passive NFFEs with one or more substantial U.S. owners, or nonparticipating FFIs. |
| Part12 | Object | Nonreporting IGA FFI information |
| Line26 | Boolean | When true, identifies the entity in Part I meets the requirements to be considered a nonreporting financial institution pursuant to an applicable IGA between the United States and country of residence and is treated as a FFI under the provisions of the applicable IGA or Treasury regulations |
| NmOfCountry | string | The name of the jurisdiction that has the IGA treated as in effect with the United States Size Range: 40 |
| IGAModel | string | Type of IGA model Allowed values |
| TreatedAs | string | Provisions under which the applicable IGA or Treasury regulations applicable Size Range: 40 |
| NmOfTrusteeOrSponsor | string | Name of trustee or sponsor Size Range:30 |
| IsTrusteeUS | Boolean | When true, identifies the Trustee or sponsor is a US citizen |
| Part13 | Object | Foreign government, government of a U.S Possesion, or foreign central bank of issue information |
| Line27 | Boolean | When true, identifies the entity in Part I is the beneficial owner of the payment, and is not engaged in commercial financial activities of a type engaged in by an insurance company, custodial institution, or depository institution with respect to the payments, accounts, or obligations for which this form is submitted (except as permitted in Regulations section 1.1471-6(h)(2)) |
| Part14 | Object | International organization infromation |
| Line28a | Boolean | When true, identifies the entity in Part I is the international organization described in section 7701(a)(18). |
| Line28b | Boolean | When true, identifies the entity in Part I: 1. Is comprised primarily of foreign governments; 2. Is recognized as an intergovernmental or supranational organization under a foreign law similar to the International Organizations Immunities Act or that has in effect a headquarters agreement with a foreign government; 3. The benefit of the entity's income does not inure to any private person; and 4. Is the beneficial owner of the payment and is not engaged in commercial financial activities of a type engaged in by an insurance company, custodial institution, or depository institution with respect to the payments, accounts, or obligations for which this form is submitted (except as permitted in Regulations section 1.1471-6(h)(2)). |
| Part15 | Object | Exempt retirement plans information |
| Line29a | Boolean | When true, identifies the entity in Part I: 1.Is established in a country with which the United States has an income tax treaty in force (see Part III if claiming treaty benefits); 2. Is operated principally to administer or provide pension or retirement benefits; and 3. Is entitled to treaty benefits on income that the fund derives from U.S. sources (or would be entitled to benefits if it derived any such income) as a resident of the other country which satisfies any applicable limitation on benefits requirement. |
| Line29b | Boolean | When true, identifies the entity in Part I: 1. Is organized for the provision of retirement, disability, or death benefits (or any combination thereof) to beneficiaries that are former employees of one or more employers in consideration for services rendered; 2. No single beneficiary has a right to more than 5% of the FFI's assets; 3. Is subject to government regulation and provides annual information reporting about its beneficiaries to the relevant tax authorities in the country in which the fund is established or operated; and (i) Is generally exempt from tax on investment income under the laws of the country in which it is established or operates due to its status as a retirement or pension plan; (ii) Receives at least 50% of its total contributions from sponsoring employers (disregarding transfers of assets from other plans described in this part, retirement and pension accounts described in an applicable Model 1 or Model 2 IGA, other retirement funds described in an applicable Model 1 or Model 2 IGA, or accounts described in Regulations section 1.1471-5(b)(2)(i)(A)); (iii) Either does not permit or penalizes distributions or withdrawals made before the occurrence of specified events related to retirement, disability, or death (except rollover distributions to accounts described in Regulations section 1.1471-5(b)(2)(i)(A) (referring to retirement and pension accounts), to retirement and pension accounts described in an applicable Model 1 or Model 2 IGA, or to other retirement funds described in this part or in an applicable Model 1 or Model 2 IGA); or (iv) Limits contributions by employees to the fund by reference to earned income of the employee or may not exceed $50,000 annually. |
| Line29c | Boolean | When true, identifies the entity in Part I: 1.Is organized for the provision of retirement, disability, or death benefits (or any combination thereof) to beneficiaries that are former employees of one or more employers in consideration for services rendered; 2. Has fewer than 50 participants; 3. Is sponsored by one or more employers each of which is not an investment entity or passive NFFE; 4. Employee and employer contributions to the fund (disregarding transfers of assets from other plans described in this part, retirement and pension accounts described in an applicable Model 1 or Model 2 IGA, or accounts described in Regulations section 1.1471-5(b)(2)(i)(A)) are limited by reference to earned income and compensation of the employee, respectively; 5. Participants that are not residents of the country in which the fund is established or operated are not entitled to more than 20% of the fund's assets; and 6. Is subject to government regulation and provides annual information reporting about its beneficiaries to the relevant tax authorities in the country in which the fund is established or operates. |
| Line29d | Boolean | When true, identifies the entity in Part 1 is formed pursuant to a pension plan that would meet the requirements of section 401(a), other than the requirement that the plan be funded by a trust created or organized in the United States. |
| Line29e | Boolean | When true, identifies the entity in Part 1 is established exclusively to earn income for the benefit of one or more retirement funds described in this part or in an applicable Model 1 or Model 2 IGA, or accounts described in Regulations section 1.1471-5(b)(2)(i)(A) (referring to retirement and pension accounts), or retirement and pension accounts described in an applicable Model 1 or Model 2 IGA. |
| Line29f | Boolean | When true, indicates the entity in Part 1 1.Is established and sponsored by a foreign government, international organization, central bank of issue, or government of a U.S. possession(each as defined in Regulations section 1.1471-6) or an exempt beneficial owner described in an applicable Model 1 or Model 2 IGA to provide retirement, disability, or death benefits to beneficiaries or participants that are current or former employees of the sponsor (or persons designated by such employees); or 2. Is established and sponsored by a foreign government, international organization, central bank of issue, or government of a U.S. possession(each as defined in Regulations section 1.1471-6) or an exempt beneficial owner described in an applicable Model 1 or Model 2 IGA to provide retirement, disability, or death benefits to beneficiaries or participants that are not current or former employees of such sponsor, but are in consideration of personal services performed for the sponsor. |
| Part16 | Object | Entity wholly owned by exempt beneficial owner's information |
| Line30 | Boolean | When true, indicates the entity in Part 1 1. Is an FFI solely because it is an investment entity; 2. Each direct holder of an equity interest in the investment entity is an exempt beneficial owner described in Regulations section 1.1471-6 or in an applicable Model 1 or Model 2 IGA; 3. Each direct holder of a debt interest in the investment entity is either a depository institution (with respect to a loan made to such entity) or an exempt beneficial owner described in Regulations section 1.1471-6 or an applicable Model 1 or Model 2 IGA. 4. Has provided an owner reporting statement that contains the name, address, TIN (if any), chapter 4 status, and a description of the type of documentation provided to the withholding agent for every person that owns a debt interest constituting a financial account or direct equity interest in the entity; and 5. Has provided documentation establishing that every owner of the entity is an entity described in Regulations section 1.1471-6(b), (c), (d), (e), (f) and/or (g) without regard to whether such owners are beneficial owners. |
| Part17 | Object | Territory financial institution information |
| Line31 | Boolean | When true, identifies that the entity in Part I is a financial institution (other than an investment entity) that is incorporated or organized under the laws of a possession of the United States. |
| Part18 | Object | Excepted non-financial group entity's information |
| Line32 | Boolean | When true, identifies that the entity in Part I 1. Is a holding company, treasury center, or captive finance company and substantially all of the entity's activities are functions described in Regulations section 1.1471-5(e)(5)(i)(C) through (E); 2. Is a member of a nonfinancial group described in Regulations section 1.1471-5(e)(5)(i)(B); 3. Is not a depository or custodial institution (other than for members of the entity's expanded affiliated group); and 4. Does not function (or hold itself out) as an investment fund, such as a private equity fund, venture capital fund, leveraged buyout fund, or any investment vehicle with an investment strategy to acquire or fund companies and then hold interests in those companies as capital assets for investment purposes |
| Part19 | Object | Excepted non-financial start-up comapany's information |
| Line33 | Boolean | When true, identifies that the entity in Part I 1. Was formed (or, in the case of a new line of business, the date of board resolution approving the new line of business)(date must be less than 24 months prior to date of payment); 2. Is not yet operating a business and has no prior operating history or is investing capital in assets with the intent to operate a new line of business other than that of a financial institution or passive NFFE; 3. Is investing capital into assets with the intent to operate a business other than that of a financial institution; and 4. Does not function (or hold itself out) as an investment fund, such as a private equity fund, venture capital fund, leveraged buyout fund, or any investment vehicle whose purpose is to acquire or fund companies and then hold interests in those companies as capital assets for investment purposes. |
| FormedOn | string | Date the start-up was formed Allowed format:MM/DD/YYYY or MM-DD-YYYY |
| Part20 | Object | Excepted non-financial entity in liquidation or bankruptcy information |
| Line34 | Boolean | When true, identifies that the entity in Part I 1. Filed a plan of liquidation, filed a plan of reorganization, or filed for bankruptcy ; 2. During the past 5 years has not been engaged in business as a financial institution or acted as a passive NFFE; 3. Is either liquidating or emerging from a reorganization or bankruptcy with the intent to continue or recommence operations as a nonfinancial entity; and 4. Has, or will provide, documentary evidence such as a bankruptcy filing or other public documentation that supports its claim if it remains in bankruptcy or liquidation for more than 3 years. |
| BankRuptcyDate | string | Date of Bankruptcy Allowed format:MM/DD/YYYY or MM-DD-YYYY |
| Part21 | Object | 501(c) Organization Information |
| Line35 | Boolean | When true, identifies that the entity in Part I 1. Has been issued a determination letter from the IRS that is currently in effect concluding that the payee is a section 501(c) organization ; or 2. Has provided a copy of an opinion from U.S. counsel certifying that the payee is a section 501(c) organization (without regard to whether the payee is a foreign private foundation). |
| IRSLetterDate | string | Effective date of the IRS determination letter Allowed format:MM/DD/YYYY or MM-DD-YYYY |
| Part22 | Object | Non-profit Organization information |
| Line36 | Boolean | When true, identifies that the entity in Part I 1. The entity is established and maintained in its country of residence exclusively for religious, charitable, scientific, artistic, cultural or educational purposes; 2. The entity is exempt from income tax in its country of residence; 3. The entity has no shareholders or members who have a proprietary or beneficial interest in its income or assets; 4. Neither the applicable laws of the entity's country of residence nor the entity's formation documents permit any income or assets of the entity to be distributed to, or applied for the benefit of, a private person or noncharitable entity other than pursuant to the conduct of the entity's charitable activities or as payment of reasonable compensation for services rendered or payment representing the fair market value of property which the entity has purchased; and 5. The applicable laws of the entity's country of residence or the entity's formation documents require that, upon the entity's liquidation or dissolution, all of its assets be distributed to an entity that is a foreign government, an integral part of a foreign government, a controlled entity of a foreign government, or another organization that is described in this part or escheats to the government of the entity's country of residence or any political subdivision thereof. |
| Part23 | Object | Publicly traded NFFE or NFFE affiliate of a publicly traded corporation information |
| Line37a | Boolean | When true, identifies 1.The entity identified in Part I is a foreign corporation that is not a financial institution; and 2.The stock of such corporation is regularly traded on one or more established securities markets, including (name one securities exchange upon which the stock is regularly traded). |
| NmOfSecurityExchange | string | Name of Security Exchange Size Range:35 |
| Line37b | Boolean | When true, identifies the entity in Part I 1. The entity identified in Part I is a foreign corporation that is not a financial institution; 2. The entity identified in Part I is a member of the same expanded affiliated group as an entity the stock of which is regularly traded on an established securities market; 3. The name of the entity, the stock of which is regularly traded on an established securities market ; and 4. The name of the securities market on which the stock is regularly traded . |
| NmOfEntity | string | The name of the entity whose stock is regularly traded Size Range: 35 |
| NmofSecurities | string | The name of the securities market on which the stock is traded Size Range: 40 |
| Part24 | Object | Excepted Territoty NFFE information |
| Line38 | Boolean | When true, identifies the entity in Part I The entity identified in Part I is an entity that is organized in a possession of the United States; 1. The entity identified in Part I: (i) Does not accept deposits in the ordinary course of a banking or similar business; (ii) Does not hold, as a substantial portion of its business, financial assets for the account of others; or (iii) Is not an insurance company (or the holding company of an insurance company) that issues or is obligated to make payments with respect to a financial account; and 2. All of the owners of the entity identified in Part I are bona fide residents of the possession in which the NFFE is organized or incorporated. |
| Part25 | Object | Active NFFE information |
| Line39 | Boolean | When true, identifies the entity in Part I 1. The entity identified in Part I is a foreign entity that is not a financial institution; 2. Less than 50% of such entity's gross income for the preceding calendar year is passive income; and 3. Less than 50% of the assets held by such entity are assets that produce or are held for the production of passive income (calculated as a weighted average of the percentage of passive assets measured quarterly) (see instructions for the definition of passive income) |
| Part26 | Object | Passive NFFE information |
| Line40a | Boolean | When true, identifies the entity in Part I as a foreign entity that is not a financial institution (excluding an investment entity organized in a possession of the United States). The entity is also not certifying its status as a publicly traded NFFE (or affiliate), excepted territory NFFE, active NFFE, direct reporting NFFE, or sponsored direct reporting NFFE |
| Line40b | Boolean | When true, identifies that the entity in Part I has no substantial U.S. owners (or, if applicable, no controlling U.S. persons). |
| Line40c | Boolean | When true, identifies that the entity in Part I has provided the name, address, and TIN of each substantial U.S. owner (or, if applicable, controlling U.S. person) of the NFFE in Part XXIX. |
| Part27 | Object | Execepted inter-affiliate FFI information |
| Line41 | Boolean | When true, identifies that the entity in Part I 1. Is a member of an expanded affiliated group; 2. Does not maintain financial accounts (other than accounts maintained for members of its expanded affiliated group); 3. Does not make withholdable payments to any person other than to members of its expanded affiliated group; 4. Does not hold an account (other than depository accounts in the country in which the entity is operating to pay for expenses) with or receive payments from any withholding agent other than a member of its expanded affiliated group; and 5. Has not agreed to report under Regulations section 1.1471-4(d)(2)(ii)(C) or otherwise act as an agent for chapter 4 purposes on behalf of any financial institution, including a member of its expanded affiliated group. |
| Part28 | Object | Sponsored Direct Reporting NFFE Information |
| NmOfSponsoringEntity | string | Name of the sponsoring entity Size Range:80 |
| Line43 | Boolean | When true, identifies the entity identified in Part I is direct reporting NFFE that is sponsored by the entity identified on line 42 |
| Part29 | Object [] | Substantial U.S Owner of Passive NFFE information |
| NmOfOwner | string | Name of the substantial U.S Owner Size Range:30 |
| Address | string | Address of the substantial U.S Owner Size Range: 40 |
| USTINType | string | TIN Type of the substantial U.S Owner.Allowed values |
| USTIN | string | Taxpayer Identification Number of the substantial U.S Owner. Size Range:10 |
| Part30 | Object | Certification information for Form W-8 BEN-E |
| IsCapacityToSign | Boolean | If true, Identifies that the recipient identified in Part I have the capacity to sign for the entity |
| SignerNm | String | Signature name of individual authorized to sign for beneficial owner Size Range:65 |
| SignDate | String | Time stamp of the signature |
| FormW8ECI | Object | Form W-8ECI Information. |
| FirstNm | String | First Name of the foreign Individual Size Range:..20 |
| MiddleNm | String | Middle Name of the foreign Individual Size Range:..20 |
| LastNm | String | Last Name of the foreign Individual Size Range:..20 |
| Suffix | String | Suffix of the Foreign Individual Size Range:..5 Allowed values |
| BusinessNm | String | Name of the Payer's business Size Range:..75 |
| TradeNm | String | Name under which the payer's business operates Size Range:..75 |
| OrganizationCountry | String | Foreign Entity or Individuals's county Size Range:2 Allowed values |
| EntityType | String | Type of Payer's EntityAllowed values |
| TINType | String | TIN type of the recipient.Allowed values |
| TIN | String | Recipient's TIN Size Range: 9-11 |
| ForeignTIN | String | Foreign TIN of the recipient. Size Range: 25 |
| IsFTINNotLegallyRequired | Boolean | When true, Identifies that beneficial owner on line 1 is not legally required to obtain an FTIN from their jurisdiction of residence. |
| PermanentAddress | object | Recipient's permanent address. |
| Address1 | String | Recipient's address. Size Range: 50 |
| Address2 | String | Recipient's suite or apartment., Size Range: 50 |
| City | String | Recipient's city Size Range: 50 |
| State | String | Recipient's state Size Range: 50 |
| Country | String | Recipient's countryAllowed values |
| PostalCd | String | Recipient's zip code Size Range: 16 |
| BusinessAddress | object | Address of the U.S. firm associated with the Beneficial Owner |
| Address1 | String | Firm's address. Size Range: 46 |
| Address2 | String | Firm's suite or apartment. Size Range: 46 |
| City | String | Firm's city Size Range: 50 |
| State | String | Firm's stateAllowed values |
| ZipCd | String | Firm's zip code Size Range: 5..10 |
| ReferenceNum | string | Recipient's reference number. You can use this field to enter any identification number you have for the recipient. Size Range: 50 |
| DOB | String | Date of Birth of the recipient Allowed format: MM-DD-YYYY or MM/DD/YYYY |
| ItemOfIncome | String | Source of income received or anticipated from the payer that is directly related to conducting trade or business activities within the United States. Size Range:..200 |
| DealerOfSecuritiesOrPTP | Boolean | When TRUE, Identifies that the recipient is a Dealer in securities or a transferor of an interest in the publicly traded partnership |
| Signature | Object | Signature of the recipient. |
| SignerNm | string | Name of the signer. Size Range: 65 |
| Errors | Object[] | Shows detailed error information. |
| Id | string | Error ID number. This ID is assigned by TaxBandits and it is unique for each error. |
| Name | string | Name of the errored node. |
| Message | string | Shows the error message. |
Request Body
- Form W9
- Form W8BEN
- Form W8BENE
- Form W8ECI
{
"FormType": "W9",
"IsTinMatching": true,
"PDFUrl": null,
"Requester": {
"BusinessId": "bec5f511-15f6-427c-9afc-f9b707783c84",
"PayerRef": null,
"TINType": null,
"TIN": null
},
"PayeeRef": "PayeeRef01",
"Email": "james@sample.com",
"FormW9": {
"Line1Nm": "SnowDaze LLC",
"Line2Nm": "Dairy Delights LLC",
"FirstNm": null,
"MiddleNm": null,
"LastNm": null,
"Suffix": null,
"TINType": "EIN",
"TIN": "83-7368273",
"TINStatus": null,
"Address": {
"Address1": "123 E. Main St",
"Address2": "Suite 400",
"City": "Rock Hill",
"State": "AA",
"ZipCd": "34001"
},
"AccountNum": null,
"FederalTaxClassification": "INDIVIDUAL",
"OtherDesc": null,
"IsLine3b": true,
"ExemptPayeeCd": null,
"ExemptFromFATCA": null,
"IsBackUpWH": "true"
},
"FormW8Ben": null,
"FormW8BENE": null,
"FormW8ECI": null
}
{
"FormType": "W8BEN",
"PDFUrl": null,
"Requester": {
"BusinessId": null,
"PayerRef": null,
"TINType": null,
"TIN": null
},
"PayeeRef": "payee-002",
"Email": "james@sample.com",
"FormW9": null,
"FormW8Ben": {
"NmOfIndividual": "John smith",
"FirstNm": "John",
"MiddleNm": null,
"LastNm": "Smith",
"Suffix": null,
"CitizenOfCountry": "US",
"USTINType": "SSN",
"USTIN": "323-45-6789",
"ForeignTIN": "342412346",
"IsFTINNotLegallyRequired": false,
"ReferenceNum": "ref-789",
"DOB": "12/01/2001",
"ExpiryDate": "06/05/2028",
"PermanentAddress": {
"Address1": "123 Main St",
"Address2": "Apt 4B",
"City": "Dothon",
"ProvinceOrStateNm": "SC",
"Country": "US",
"PostalCd": "29730"
},
"MailingAddress": {
"Address1": "456 Elm St",
"Address2": null,
"City": "Othertown",
"ProvinceOrStateNm": "SC",
"Country": "US",
"PostalCd": "29730"
},
"TaxTreatyBenefits": {
"BeneficiaryCountry": "CA",
"ClaimingProvArticlePara": "Article 12",
"RateOfWH": 15,
"TypeOfIncome": "Dividends",
"AdditionalConditions": null
},
"Signature": {
"SignerNm": "John smith"
},
"FormW8BENE": null,
"FormW8ECI": null
}
}
{
"FormType": "W8BENE",
"PDFUrl": null,
"Requester": {
"BusinessId": null,
"PayerRef": null,
"TINType": null,
"TIN": null
},
"PayeeRef": "Payee003",
"Email": "james@sample.com",
"FormW9": null,
"FormW8Ben": null,
"FormW8BENE": {
"Part1": {
"NmOfOrganization": "SnowDaze LLC",
"CountryOfOrganization": "AF",
"NmOfDisregardedEntity": null,
"Ch3Status": "DISREGARDED_ENTITY",
"IsEntityTreatyClaim": true,
"Ch4Status": "REGISTERED_DEEMED_COMPLIANT_FFI",
"USTINType": "SSN",
"USTIN": "764563403",
"GIIN": "543232.55A35.RG.346",
"ForeignTIN": null,
"IsFTINNotLegallyRequired": true,
"ReferenceNum": "Ref001",
"PermanentAdd": {
"Address1": "1751 Kinsey Rd",
"Address2": "Main St",
"City": "Dothan",
"State": "TN",
"Country": "IN",
"PostalCd": "641016"
},
"MailAdd": {
"Address1": "1751 Kinsey Rd",
"Address2": "Main St",
"City": "Dothan",
"State": "TN",
"Country": "IN",
"PostalCd": "641016"
}
},
"Part2": {
"Ch4StatusOfDisregardedEntity": "BRANCH_TREATED_AS_NONPARTICIPATING_FFI",
"AddrOfDisregardedEntity": {
"Address1": "123 Main street",
"Address2": null,
"City": "Test",
"State": "NY",
"Country": "AF",
"PostalCd": "10001-4334"
},
"GIIN": "54323A.55A35.RF.346"
},
"Part3": {
"IsBeneficiaryCountryTreatedWithin": true,
"BeneficiaryCountry": "US",
"IsBeneficiaryClaimingTreatyBenefits": true,
"LimitationOnBenefits": "COMPANY_THAT_MEETS_THE_DERIVATIVE_BENEFITS_TEST",
"OthersDetail": null,
"IsBenifitsForUSSourceFromForeignCorp": true,
"ClaimingProvArticlePara": "Test",
"RateOfWH": 32,
"TypeOfIncome": "354325",
"AdditionalConditions": null
},
"Part4": null,
"Part5": null,
"Part6": null,
"Part7": null,
"Part8": null,
"Part9": null,
"Part10": null,
"Part11": null,
"Part12": null,
"Part13": null,
"Part14": null,
"Part15": null,
"Part16": null,
"Part17": null,
"Part18": null,
"Part19": null,
"Part20": null,
"Part21": null,
"Part22": null,
"Part23": null,
"Part24": null,
"Part25": null,
"Part26": null,
"Part27": null,
"Part28": null,
"Part29": null,
"Part30": {
"IsCapacityToSign": true,
"SignerNm": "John Doe",
"SignDate": "2024-10-24T07:02:15.217"
}
},
"FormW8ECI": null
}
{
"FormType": "W8ECI",
"IsTinMatching": false,
"PDFUrl": null,
"Requester": {
"BusinessId": "131a4072-3941-437c-8059-3b2a9e5f74f2",
"PayerRef": null,
"TINType": null,
"TIN": null
},
"PayeeRef": "payee-005",
"Email": "james@sample.com",
"FormW9": null,
"FormW8Ben": null,
"FormW8BENE": null,
"FormW8ECI": {
"FirstNm": "John",
"MiddleNm": null,
"LastNm": "Smith",
"Suffix": null,
"BusinessNm": null,
"OrganizationCountry": "IN",
"TradeNm": null,
"EntityType": "INDIVIDUAL",
"TINType": "SSN",
"TIN": "83-7468274",
"ForeignTIN": null,
"IsFTINNotLegallyRequired": true,
"ReferenceNum": "123434",
"DOB": "11-11-2000",
"ItemOfIncome": "Wages",
"DealerOfSecuritiesOrPTP": false,
"PermanentAddress": {
"Address1": "71 SAINT NICHOLAS DR",
"Address2": null,
"City": "NORTH POLE",
"State": "AK",
"Country": "US",
"PostalCd": "99705"
},
"BusinessAddress": {
"Address1": "71 SAINT NICHOLAS DR",
"Address2": null,
"City": "NORTH POLE",
"State": "AK",
"Country": "US",
"ZipCd": "99705"
},
"Signature": {
"SignerNm": "John"
}
}
}
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code |
| StatusMessage | string | Detailed status message |
| SubmissionId | Guid | Unique identifier of a submission |
| BusinessId | Guid | Unique identifier of a Business. |
| BusinessNm | string | Name of the business |
| FirstNm | string | First Name of the Individual |
| MiddleNm | string | Middle Name of the Individual |
| LastNm | string | Last Name of the Individual |
| Suffix | string | Suffix of the Individual |
| RecipientId | Guid | A unique identifier generated by TaxBandits for a Recipient. You can use this ID for your future reference to Update. |
| PayeeRef | string | A unique identifier for each payee completing their information. |
| PdfUrl | string | URL to download the completed Withholding certificate form. Note: This URL will expire in 24 hours. |
| Status | string | RecordStatus Status of the Withholding certificate |
| StatusTs | string | Timestamp of the withholding certificate form Status. |
| TINMatching | Object | TIN Matching information. |
| Status | String | TIN Matching status. |
| StatusTs | String | Timestamp of the TIN Matching Status. |
| StatusMsg | String | Status message of the TIN Matching. |
| Errors | object[] | Shows the detailed error message. |
| Errors | Object[] | Detailed error information. |
| Id | string | Error ID number. This ID is assigned by TaxBandits and it is unique for each error. |
| Name | string | Name of the errored node. |
| Message | string | Shows the error message |
Response JSON
- 200
- 400
- 401
Success Response - This is a sample response for successful API requests.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "a83956b3-54c9-45ee-bca5-233932dac509",
"BusinessId": "8dd045f9-88c1-4694-a713-7b21e406b098",
"BusinessNm": "Snowdaze LLC",
"FirstNm": null,
"LastNm": null,
"MiddleNm": null,
"Suffix": null,
"RecipientId": "6600e5ef-839a-485f-9766-513e09e19hjn",
"PayeeRef": "payee78374",
"PDFUrl": "pdfs/3435543a-7315-4983-806a-1f003b7ab95f/8dd045f9-88c1-4694-a713-7b21e406ba03/FormW9/FormW9_16412.pdf",
"Status": "COMPLETED_AND_TIN_MATCH_INPROGRESS",
"StatusTs": "2025-06-05 03:54:21 -04:00",
"TINMatching": {
"Status": "ORDER_CREATED",
"StatusTs": "2025-06-05 03:54:21 -04:00",
"StatusMsg": null,
"Errors": null
},
"Errors": null
}
Bad Request Response - You'll get the below response when your API requests contain any validation errors.
{
"StatusCode": 400,
"StatusName": "BadRequest",
"StatusMessage": "Validation error has occurred",
"SubmissionId": "00000000-0000-0000-0000-000000000000",
"BusinessId": "00000000-0000-0000-0000-000000000000",
"RecipientId": "00000000-0000-0000-0000-000000000000",
"PayeeRef": null,
"PDFUrl": null,
"Status": null,
"StatusTs": null,
"TINMatching": null,
"Errors": [
{
"Id": "F49-100071",
"Name": "FormW8Ben.TaxTreatyBenefits.RateOfWH",
"Message": "Percentage of rate of withholding should not exceed 40%"
}
]
}
Unauthorized Response - You'll get the below response when your API requests don't contain valid authentication credentials.
{
"StatusCode": 401,
"StatusName": "Unauthorized",
"StatusMessage": "Invalid authorization credentials",
"Errors": [
{
"Id": "AUTH-100018",
"Name": "Authorization",
"Message": "JWT EXPIRED"
}
]
}