Retrieve the status of a 1099 form

List forms

Endpoint: GET /1099/forms/{id}

Use case:

Use this endpoint to check the current status of a specific 1099 form. This includes:

Filing and processing status with the IRS or state
Mailing and delivery status
Validation results for TIN matching and address validation

This is especially useful when:

You want to confirm that a form has been successfully filed
You need to appear status updates to internal teams or recipients
You want to confirm that a form is complete programmatically before taking further actions

1 endpoint, all form types

This endpoint supports all 1099 form types. Provide the unique id that the system returned when you created or updated the form (for example, from POST /1099/forms or PUT /1099/forms/{id}).

Note

Use the system-generated form id, not the referenceId.

Sample request

Example: Retrieve form status

GET /1099/forms/287184161

Sample response

{
    "nonemployeeCompensation": 2000.0,
    "directSalesIndicator": true,
    "federalIncomeTaxWithheld": null,
    "type": "1099-NEC",
    "id": "287184161",
    "issuerId": "141536301",
    "issuerReferenceId": "ACME-2025-002",
    "issuerTin": "456-00-0000",
    "taxYear": 2024,
    "referenceId": "NEC-2024-002",
    "tin": "789-00-0000",
    "recipientName": "Jane Smith",
    "tinType": "SSN",
    "recipientSecondName": "Jane Enterprises",
    "address": "456 Main Street",
    "address2": "Suite 200",
    "city": "New York",
    "state": "NY",
    "zip": "10001",
    "email": "jane.smith@example.com",
    "accountNumber": "ACC654321",
    "officeCode": "NY02",
    "nonUsProvince": null,
    "countryCode": "US",
    "federalEfileDate": "2024-09-15",
    "postalMail": true,
    "stateEfileDate": null,
    "recipientEdeliveryDate": "2024-09-25",
    "tinMatch": true,
    "noTin": false,
    "addressVerification": true,
    "stateAndLocalWithholding": {
        "stateTaxWithheld": null,
        "state": null,
        "stateIdNumber": null,
        "stateIncome": 0.0,
        "localTaxWithheld": 0.0,
        "locality": null,
        "localityIdNumber": null,
        "localIncome": 0.0
    },
    "secondTinNotice": false,
    "federalEfileStatus": {
        "time": "2025-08-29T00:00:00+00:00",
        "status": "scheduled"
    },
    "stateEfileStatus": [],
    "postalMailStatus": {
        "time": null,
        "status": "pending"
    },
    "tinMatchStatus": {
        "time": null,
        "status": "pending"
    },
    "addressVerificationStatus": {
        "time": "2025-08-29T15:38:12-04:00",
        "status": "pending"
    },
    "eDeliveryStatus": {
        "time": "2024-09-25T00:00:00+00:00",
        "status": "scheduled"
    },
    "validationErrors": [],
    "createdAt": "2025-08-29T19:37:23.770000",
    "updatedAt": "2025-08-29T19:38:12.886000"
}

Key status fields explained

federalEfileStatus: Tracks whether you submitted the form to the IRS.
stateEfileStatus: Tracks e-filing status for individual states (which can include multiple entries).
All the statuses above for federalEfileStatus also applies to stateEfileStatus, with the addition of the list below that are specific for the state eFilling process:
- Rejected - the 1099 & W-9 has been rejected by the state.
- Corrected Rejected - the 1099 & W-9 correction has been rejected by the state.
eDeliveryStatus: Tracks whether someone emailed the form to the recipient.
- Unscheduled - you haven't scheduled the 1099 & W-9 for e-delivery.
- Scheduled - the 1099 & W-9 has been scheduled for e-delivery but not yet sent.
- Sent - the 1099 & W-9 recipient has been emailed but they haven’t yet downloaded their form.
- Accepted - the 1099 & W-9 recipient has downloaded their 1099 & W-9.
- Bounced - the email sent to the 1099 & W-9 recipient bounced.
- Bad Verify - the 1099 & W-9 recipient entered the last 4 digits of their SSN/EIN that differed from what Avalara stores (usually indicates that you have an incorrect SSN/EIN on file for the recipient).
- Bad Verify Limit - the 1099 & W-9 recipient entered in an incorrect last 4 of their SSN/EIN multiple times and the form is now locked for e-delivery.
postalMailStatus: Status of paper delivery, if you set postalMail to true.
- Unscheduled - the 1099 & W-9 hasn’t been scheduled for postal mail to the recipient.
- Scheduled - the system has scheduled the 1099 & W-9 for postal mail to the recipient.
- Sent - the 1099 & W-9 has been submitted to our mailing vendor.
- Delivered - the 1099 & W-9 has been delivered to the recipient.
tinMatchStatus: Result of the TIN validation, if requested.
- none: No TIN match scheduled/attempted.
- pending: TIN match request sent but no response yet.
- matched: TIN/Name combination matches IRS records.
- failed: TIN/Name combination does NOT match IRS records.
- Unknown: Invalid request, duplicate request, or other IRS error.
addressVerificationStatus: Result of the address validation, if enabled.
- pending: VerificationGuidance: Domains Avalara core Definition The process of confirming that something is true. Note Usage: "Verification" is a generic term for general use. Use "authentication" when referring to the process of confirming a user's identity. But see: authentication submitted but no result yet.
- incomplete: Result received but user hasn't decided.
- verified: User accepted the suggested changes.
- unchanged: User rejected the suggested changes.
- failed: VerificationGuidance: Domains Avalara core Definition The process of confirming that something is true. Note Usage: "Verification" is a generic term for general use. Use "authentication" when referring to the process of confirming a user's identity. But see: authentication failed or address not found.
- Unknown: No address validation record exists.

Each status object includes a status string and a time field that shows when you completed the action.