# Retrieve the status of a 1099 form Source: https://developer.avalara.com/products/avalara-1099-and-w9/integration-guides/1099-and-w-9/ctb1706221641611/ Guide: 1099 & W-9 # Retrieve the status of a 1099 form Learn how to retrieve the current status of a specific 1099 form, including filing, mailing, and validation details. ## 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. - `Unscheduled` - You created the 1099 & W-9 but haven’t yet scheduled it for e-filing. - `Scheduled` - AvaTax has scheduled the 1099 & W-9 for e-filing but hasn’t yet sent it to the IRS. - `Sent` - the 1099 & W-9 has been submitted to the IRS but the IRS hasn’t yet processed the submission. Typically a 1099 & W-9 will remain in this status for 2-5 days before the IRS processes the submission. - `Accepted` - the 1099 & W-9 has been submitted and the IRS has processed the submission. - `Corrected Scheduled` - you updated the 1099 & W-9 that you previously submitted to the IRS, and the system will send a correction to the IRS. - `Corrected Sent` - you sent a correction to the IRS but the IRS hasn't yet processed it. - `Corrected Accepted` - you sent a correction to the IRS and the IRS processed it. - `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.