Avalara 1099 & W-9

Version avalara1099
Companies W9
Forms 1099
Forms W9
Issuers 1099
Jobs

Form1099Base

Parameters
typeRequired
string

Form type.

Enum: 1042-S, 1095-B, 1095-C, 1099-DIV, 1099-INT, 1099-K, 1099-MISC, 1099-NEC, 1099-R, W-2
idOptional
string

Form ID. Unique identifier set when the record is created.

issuerIdOptional
string

Issuer ID - only required when creating forms

issuerReferenceIdOptional
string

Issuer Reference ID - only required when creating forms via $bulk-upsert

issuerTinOptional
string

Issuer TIN - readonly

taxYearOptional
integer

Tax Year - only required when creating forms via $bulk-upsert

referenceIdOptional
string

Internal reference ID. Never shown to any agency or recipient.

tinOptional
string

Recipient's Federal Tax Identification Number (TIN).

recipientNameRequired
string

Recipient name

tinTypeOptional
string

Tax Identification Number (TIN) type.

Available values:

  • EIN: Employer Identification Number
  • SSN: Social Security Number
  • ITIN: Individual Taxpayer Identification Number
  • ATIN: Adoption Taxpayer Identification Number
Enum: EIN, SSN, ITIN, ATIN
recipientSecondNameOptional
string

Recipient second name

addressRequired
string

Address.

address2Optional
string

Address line 2.

cityRequired
string

City.

stateOptional
string

Two-letter US state or Canadian province code (required for US/CA addresses).

zipOptional
string

ZIP/postal code.

emailOptional
string

Recipient's Contact email address.

accountNumberOptional
string

Account number

officeCodeOptional
string

Office code

nonUsProvinceOptional
string

Province or region for non-US/CA addresses.

countryCodeRequired
string

Two-letter IRS country code (e.g., 'US', 'CA'), as defined at https://www.irs.gov/e-file-providers/country-codes.

federalEfileDateOptional
string

Date when federal e-filing should be scheduled. If set between current date and beginning of blackout period, scheduled to that date. If in the past or blackout period, scheduled to next available date. For blackout period information, see https://www.track1099.com/info/IRS_info. Set to null to leave unscheduled.

postalMailOptional
boolean

Boolean indicating that postal mailing to the recipient should be scheduled for this form

stateEfileDateOptional
string

Date when state e-filing should be scheduled. Must be on or after federalEfileDate. If set between current date and beginning of blackout period, scheduled to that date. If in the past or blackout period, scheduled to next available date. For blackout period information, see https://www.track1099.com/info/IRS_info. Set to null to leave unscheduled.

recipientEdeliveryDateOptional
string

Date when recipient e-delivery should be scheduled. If set between current date and beginning of blackout period, scheduled to that date. If in the past or blackout period, scheduled to next available date. For blackout period information, see https://www.track1099.com/info/IRS_info. Set to null to leave unscheduled.

tinMatchOptional
boolean

Boolean indicating that TIN Matching should be scheduled for this form

noTinOptional
boolean

No TIN indicator

addressVerificationOptional
boolean

Boolean indicating that address verification should be scheduled for this form

stateAndLocalWithholdingOptional

State and local withholding information

secondTinNoticeOptional
boolean

Second TIN notice

federalEfileStatusOptional

Federal e-file status. Available values:

  • unscheduled: Form has not been scheduled for federal e-filing
  • scheduled: Form is scheduled for federal e-filing
  • airlock: Form is in process of being uploaded to the IRS (forms exist in this state for a very short period and cannot be updated while in this state)
  • sent: Form has been sent to the IRS
  • accepted: Form was accepted by the IRS
  • corrected_scheduled: Correction is scheduled to be sent
  • corrected_airlock: Correction is in process of being uploaded to the IRS (forms exist in this state for a very short period and cannot be updated while in this state)
  • corrected: A correction has been sent to the IRS
  • corrected_accepted: Correction was accepted by the IRS
  • rejected: Form was rejected by the IRS
  • corrected_rejected: Correction was rejected by the IRS
  • held: Form is held and will not be submitted to IRS (used for certain forms submitted only to states)
stateEfileStatusOptional
array

State e-file status. Available values:

  • unscheduled: Form has not been scheduled for state e-filing
  • scheduled: Form is scheduled for state e-filing
  • airlocked: Form is in process of being uploaded to the state
  • sent: Form has been sent to the state
  • rejected: Form was rejected by the state
  • accepted: Form was accepted by the state
  • corrected_scheduled: Correction is scheduled to be sent
  • corrected_airlocked: Correction is in process of being uploaded to the state
  • corrected_sent: Correction has been sent to the state
  • corrected_rejected: Correction was rejected by the state
  • corrected_accepted: Correction was accepted by the state
postalMailStatusOptional

Postal mail to recipient status. Available values:

  • unscheduled: Postal mail has not been scheduled
  • pending: Postal mail is pending to be sent
  • sent: Postal mail has been sent
  • delivered: Postal mail has been delivered
tinMatchStatusOptional

TIN Match status. Available values:

  • none: TIN matching has not been performed
  • pending: TIN matching request is pending
  • matched: Name/TIN combination matches IRS records
  • unknown: TIN is missing, invalid, or request contains errors
  • rejected: Name/TIN combination does not match IRS records or TIN not currently issued
addressVerificationStatusOptional

Address verification status. Available values:

  • unknown: Address verification has not been checked
  • pending: Address verification is in progress
  • failed: Address verification failed
  • incomplete: Address verification is incomplete
  • unchanged: User declined address changes
  • verified: Address has been verified and accepted
eDeliveryStatusOptional

EDelivery status. Available values:

  • unscheduled: E-delivery has not been scheduled
  • scheduled: E-delivery is scheduled to be sent
  • sent: E-delivery has been sent to recipient
  • bounced: E-delivery bounced back (invalid email)
  • refused: E-delivery was refused by recipient
  • bad_verify: E-delivery failed verification
  • accepted: E-delivery was accepted by recipient
  • bad_verify_limit: E-delivery failed verification limit reached
  • second_delivery: Second e-delivery attempt
  • undelivered: E-delivery is undelivered (temporary state allowing resend)
validationErrorsOptional
array

Validation errors

createdAtOptional
string

Date time when the record was created.

updatedAtOptional
string

Date time when the record was last updated.