Avalara 1099 & W-9

OverviewAPISDKIntegration guides
Version avalara1099
Companies W9
Forms 1099
Forms W9
Issuers 1099
Jobs

W8BenFormRequest

This model is used in the following APIs:

Parameters
typeOptional
string

The form type (always "w8ben" for this model).

Enum: W4, W8Ben, W8BenE, W8Imy, W9
nameRequired
string

The name of the individual or entity associated with the form.

citizenshipCountryRequired
string

The country of citizenship.. Allowed values: US, AF, AX, AL, AG, AQ, AN, AO, AV, AY (and 248 more)

Enum: US, AF, AX, AL, AG, AQ, AN, AO, AV, AY, AC, AR, AM, AA, AT, AS, AU, AJ, BF, BA, FQ, BG, BB, BO, BE, BH, BN, BD, BT, BL, BK, BC, BV, BR, IO, VI, BX, BU, UV, BM, BY, CB, CM, CA, CV, CJ, CT, CD, CI, CH, KT, IP, CK, CO, CN, CF, CG, CW, CR, CS, IV, HR, CU, UC, CY, EZ, DA, DX, DJ, DO, DR, TT, EC, EG, ES, EK, ER, EN, ET, FK, FO, FM, FJ, FI, FR, FP, FS, GB, GA, GG, GM, GH, GI, GR, GL, GJ, GQ, GT, GK, GV, PU, GY, HA, HM, VT, HO, HK, HQ, HU, IC, IN, ID, IR, IZ, EI, IS, IT, JM, JN, JA, DQ, JE, JQ, JO, KZ, KE, KQ, KR, KN, KS, KV, KU, KG, LA, LG, LE, LT, LI, LY, LS, LH, LU, MC, MK, MA, MI, MY, MV, ML, MT, IM, RM, MR, MP, MX, MQ, MD, MN, MG, MJ, MH, MO, MZ, WA, NR, BQ, NP, NL, NC, NZ, NU, NG, NI, NE, NF, CQ, NO, MU, OC, PK, PS, LQ, PM, PP, PF, PA, PE, RP, PC, PL, PO, RQ, QA, RO, RS, RW, TB, RN, WS, SM, TP, SA, SG, RI, SE, SL, SN, NN, LO, SI, BP, SO, SF, SX, SP, PG, CE, SH, SC, ST, SB, VC, SU, NS, SV, WZ, SW, SZ, SY, TW, TI, TZ, TH, TO, TL, TN, TD, TS, TU, TX, TK, TV, UG, UP, AE, UK, UY, UZ, NH, VE, VM, VQ, WQ, WF, WI, YM, ZA, ZI
residenceAddressOptional
string

The residential address of the individual or entity.

residenceCityOptional
string

The city of residence.

residenceStateOptional
string

The state of residence. Required for US and Canada.. Allowed values: AA, AE, AK, AL, AP, AR, AS, AZ, CA, CO (and 65 more)

Enum: AA, AE, AK, AL, AP, AR, AS, AZ, CA, CO, CT, DC, DE, FL, FM, GA, GU, HI, IA, ID, IL, IN, KS, KY, LA, MA, MD, ME, MH, MI, MN, MO, MP, MS, MT, NC, ND, NE, NH, NJ, NM, NV, NY, OH, OK, OR, PA, PR, PW, RI, SC, SD, TN, TX, UT, VA, VI, VT, WA, WI, WV, WY, AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT
residenceZipOptional
string

The ZIP code of the residence.

residenceCountryRequired
string

The country of residence.. Allowed values: US, AF, AX, AL, AG, AQ, AN, AO, AV, AY (and 248 more)

Enum: US, AF, AX, AL, AG, AQ, AN, AO, AV, AY, AC, AR, AM, AA, AT, AS, AU, AJ, BF, BA, FQ, BG, BB, BO, BE, BH, BN, BD, BT, BL, BK, BC, BV, BR, IO, VI, BX, BU, UV, BM, BY, CB, CM, CA, CV, CJ, CT, CD, CI, CH, KT, IP, CK, CO, CN, CF, CG, CW, CR, CS, IV, HR, CU, UC, CY, EZ, DA, DX, DJ, DO, DR, TT, EC, EG, ES, EK, ER, EN, ET, FK, FO, FM, FJ, FI, FR, FP, FS, GB, GA, GG, GM, GH, GI, GR, GL, GJ, GQ, GT, GK, GV, PU, GY, HA, HM, VT, HO, HK, HQ, HU, IC, IN, ID, IR, IZ, EI, IS, IT, JM, JN, JA, DQ, JE, JQ, JO, KZ, KE, KQ, KR, KN, KS, KV, KU, KG, LA, LG, LE, LT, LI, LY, LS, LH, LU, MC, MK, MA, MI, MY, MV, ML, MT, IM, RM, MR, MP, MX, MQ, MD, MN, MG, MJ, MH, MO, MZ, WA, NR, BQ, NP, NL, NC, NZ, NU, NG, NI, NE, NF, CQ, NO, MU, OC, PK, PS, LQ, PM, PP, PF, PA, PE, RP, PC, PL, PO, RQ, QA, RO, RS, RW, TB, RN, WS, SM, TP, SA, SG, RI, SE, SL, SN, NN, LO, SI, BP, SO, SF, SX, SP, PG, CE, SH, SC, ST, SB, VC, SU, NS, SV, WZ, SW, SZ, SY, TW, TI, TZ, TH, TO, TL, TN, TD, TS, TU, TX, TK, TV, UG, UP, AE, UK, UY, UZ, NH, VE, VM, VQ, WQ, WF, WI, YM, ZA, ZI
residenceIsMailingOptional
boolean

Indicates whether the residence address is the mailing address.

mailingAddressOptional
string

The mailing address.

mailingCityOptional
string

The city of the mailing address.

mailingStateOptional
string

The state of the mailing address. Required for US and Canada.. Allowed values: AA, AE, AK, AL, AP, AR, AS, AZ, CA, CO (and 65 more)

Enum: AA, AE, AK, AL, AP, AR, AS, AZ, CA, CO, CT, DC, DE, FL, FM, GA, GU, HI, IA, ID, IL, IN, KS, KY, LA, MA, MD, ME, MH, MI, MN, MO, MP, MS, MT, NC, ND, NE, NH, NJ, NM, NV, NY, OH, OK, OR, PA, PR, PW, RI, SC, SD, TN, TX, UT, VA, VI, VT, WA, WI, WV, WY, AB, BC, MB, NB, NL, NS, NT, NU, ON, PE, QC, SK, YT
mailingZipOptional
string

The ZIP code of the mailing address.

mailingCountryRequired
string

The country of the mailing address.. Allowed values: US, AF, AX, AL, AG, AQ, AN, AO, AV, AY (and 248 more)

Enum: US, AF, AX, AL, AG, AQ, AN, AO, AV, AY, AC, AR, AM, AA, AT, AS, AU, AJ, BF, BA, FQ, BG, BB, BO, BE, BH, BN, BD, BT, BL, BK, BC, BV, BR, IO, VI, BX, BU, UV, BM, BY, CB, CM, CA, CV, CJ, CT, CD, CI, CH, KT, IP, CK, CO, CN, CF, CG, CW, CR, CS, IV, HR, CU, UC, CY, EZ, DA, DX, DJ, DO, DR, TT, EC, EG, ES, EK, ER, EN, ET, FK, FO, FM, FJ, FI, FR, FP, FS, GB, GA, GG, GM, GH, GI, GR, GL, GJ, GQ, GT, GK, GV, PU, GY, HA, HM, VT, HO, HK, HQ, HU, IC, IN, ID, IR, IZ, EI, IS, IT, JM, JN, JA, DQ, JE, JQ, JO, KZ, KE, KQ, KR, KN, KS, KV, KU, KG, LA, LG, LE, LT, LI, LY, LS, LH, LU, MC, MK, MA, MI, MY, MV, ML, MT, IM, RM, MR, MP, MX, MQ, MD, MN, MG, MJ, MH, MO, MZ, WA, NR, BQ, NP, NL, NC, NZ, NU, NG, NI, NE, NF, CQ, NO, MU, OC, PK, PS, LQ, PM, PP, PF, PA, PE, RP, PC, PL, PO, RQ, QA, RO, RS, RW, TB, RN, WS, SM, TP, SA, SG, RI, SE, SL, SN, NN, LO, SI, BP, SO, SF, SX, SP, PG, CE, SH, SC, ST, SB, VC, SU, NS, SV, WZ, SW, SZ, SY, TW, TI, TZ, TH, TO, TL, TN, TD, TS, TU, TX, TK, TV, UG, UP, AE, UK, UY, UZ, NH, VE, VM, VQ, WQ, WF, WI, YM, ZA, ZI
tinOptional
string

The taxpayer identification number (TIN).

foreignTinNotRequiredOptional
boolean

Indicates whether a foreign TIN is not legally required.

foreignTinOptional
string

The foreign taxpayer identification number (TIN).

referenceNumberOptional
string

A reference number for the form.

birthdayOptional
string

The birthday of the individual associated with the form.

treatyCountryOptional
string

The country for which the treaty applies.. Allowed values: US, AF, AX, AL, AG, AQ, AN, AO, AV, AY (and 248 more)

Enum: US, AF, AX, AL, AG, AQ, AN, AO, AV, AY, AC, AR, AM, AA, AT, AS, AU, AJ, BF, BA, FQ, BG, BB, BO, BE, BH, BN, BD, BT, BL, BK, BC, BV, BR, IO, VI, BX, BU, UV, BM, BY, CB, CM, CA, CV, CJ, CT, CD, CI, CH, KT, IP, CK, CO, CN, CF, CG, CW, CR, CS, IV, HR, CU, UC, CY, EZ, DA, DX, DJ, DO, DR, TT, EC, EG, ES, EK, ER, EN, ET, FK, FO, FM, FJ, FI, FR, FP, FS, GB, GA, GG, GM, GH, GI, GR, GL, GJ, GQ, GT, GK, GV, PU, GY, HA, HM, VT, HO, HK, HQ, HU, IC, IN, ID, IR, IZ, EI, IS, IT, JM, JN, JA, DQ, JE, JQ, JO, KZ, KE, KQ, KR, KN, KS, KV, KU, KG, LA, LG, LE, LT, LI, LY, LS, LH, LU, MC, MK, MA, MI, MY, MV, ML, MT, IM, RM, MR, MP, MX, MQ, MD, MN, MG, MJ, MH, MO, MZ, WA, NR, BQ, NP, NL, NC, NZ, NU, NG, NI, NE, NF, CQ, NO, MU, OC, PK, PS, LQ, PM, PP, PF, PA, PE, RP, PC, PL, PO, RQ, QA, RO, RS, RW, TB, RN, WS, SM, TP, SA, SG, RI, SE, SL, SN, NN, LO, SI, BP, SO, SF, SX, SP, PG, CE, SH, SC, ST, SB, VC, SU, NS, SV, WZ, SW, SZ, SY, TW, TI, TZ, TH, TO, TL, TN, TD, TS, TU, TX, TK, TV, UG, UP, AE, UK, UY, UZ, NH, VE, VM, VQ, WQ, WF, WI, YM, ZA, ZI
treatyArticleOptional
string

The specific article of the treaty being claimed.

treatyReasonsOptional
string

The reasons for claiming treaty benefits.

withholdingRateOptional
string

The withholding rate applied as per the treaty. Must be a percentage with up to two decimals (e.g., 12.50, 0).. Allowed values: 0, 0.0, 0.00, 5, 5.5, 10, 12.50, 15, 20, 25 (and 1 more)

Enum: 0, 0.0, 0.00, 5, 5.5, 10, 12.50, 15, 20, 25, 30
incomeTypeOptional
string

The type of income covered by the treaty.

signerNameOptional
string

The name of the signer of the form.