Status

Status

This endpoint can be used to retrieve the status of 1099/W-2 returns transmitted via the TaxBandits API. Provide the SubmissionId and RecordId, and the response will return the status of federal filing, state filing, postal mailing, and online access.

Federal Filing

• CREATED - The form has been created but not yet transmitted.
• TRANSMITTED - The form has been transmitted by the user.
• SENT_TO_AGENCY - The form has been sent to the IRS/SSA, and a result is pending.
• ACCEPTED - The form has been accepted by the IRS/SSA.
• ACCEPTED_WITH_ERRORS - Applicable only to 1099 forms. The IRS has accepted the return with validation errors; a correction must be filed as soon as possible.
  (Applicable only for returns filed using the IRIS filing format.)
• REJECTED - The form has been rejected by the IRS/SSA due to errors. The user must correct the errors and retransmit.
• YET_TO_RETRANSMIT - The rejected form has been updated and is pending retransmission to the IRS/SSA.

State Filing

• CREATED - The form has been created but not yet transmitted.
• NOT_CREATED - The form hasn't been created because state filing wasn't opted for.
• TRANSMITTED - The form has been transmitted by the user.
• SENT_TO_AGENCY - The form has been sent to the state DOR, and a result is pending.
• ACCEPTED - The form has been accepted by the state DOR.
• REJECTED - The form has been rejected by the state DOR.

Postal Mailing

• CREATED - Postal mailing has been opted for.
• SENT - Form copies have been mailed to the recipient.
• RECEIVED - Form copies have been received by the recipient.
• NOT_CREATED - Postal mailing wasn't opted for. To enable it, set IsPostalMailing to TRUE in the submission manifest of the Create request.

Online Access

• CREATED - Online Access has been opted for; a secure download link will be emailed to the recipient once the form is transmitted.
• ORDER_CREATED - dOnline Access has been opted for; a secure download link will be emailed to the recipient once the form is transmitted.be sent shortly.
• EMAIL_SENT - A secure link to download the form has been emailed to the recipient.
• VIEWED_FORM - The recipient has viewed the form.
• DOWNLOADED_FORM - The recipient has viewed and downloaded the form.

GET form1099w2/status 

Run in Postman

Request Body

Field	Type	Description
SubmissionId	Guid	A unique identifier of a submission.
RecordIds	Guid	A unique identifier generated by TaxBandits when a return's is created. Mention the return RecordId for which you want to get the status.

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier generated for the submission.
FormType	string	Denotes the type of the form.
1099W2Records	object[]	Returns the status of processed records along with their federal, state, and distribution statuses.
RecordId	Guid	Unique identifier generated for the submitted tax form record.
FederalStatus	object	Returns the federal filing status details for the record.
Code	string	Status code representing the federal filing result.
Status	string	Current status of the federal filing (for example, ACCEPTED, REJECTED).
Message	string	Detailed description of the federal filing status.
StatusTs	string	Date and time when the federal filing status was last updated.
StateStatus	object	Returns the filing status details for each state where the return was filed.
StateCd	string	Two-letter state code for the filing jurisdiction.
Code	string	Status code representing the state filing result.
Status	string	Current filing status for the specified state.
Message	string	Detailed description of the state filing status.
StatusTs	string	Date and time when the state filing status was last updated.
Distribution	object	Returns the distribution details for the recipient copy of the form.
DistributionType	string	Specifies the distribution method used to deliver the recipient copy (for example, POSTAL_AND_ONLINE).
PostalStatus	object	Returns the postal delivery status information.
PostalType	string	Specifies the postal delivery service used (for example, USPS_FIRST_CLASS).
Code	string	Status code representing the postal delivery status.
Status	string	Current postal delivery status (for example, ASSUMED_DELIVERED, IN_TRANSIT).
Message	string	Detailed description of the postal delivery status.
StatusTs	string	Date and time when the postal delivery status was last updated.
OnlineAccessStatus	object	Returns the online access status information for the recipient.
Email	string	Email address provided for recipient online access.
Code	string	Status code representing the online access status.
Status	string	Current status of online access (for example, VIEWED_FORM, EMAIL_SENT).
Message	string	Detailed description of the online access status.
StatusTs	string	Date and time when the online access status was last updated.
Errors	object[]	Returns top-level validation or processing errors. Returns null when the request is processed successfully.
Id	string	Validation or processing error code.
Name	string	Name of the field or validation rule that caused the error.
Message	string	Detailed description of the error and guidance for resolving it.
ErrorRecords	object[]	It will show the detailed information about the error status of the Form 1099-NEC Records.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record. The SequenceId will be returned in the response for your reference.
RecordId	Guid	A unique identifier of a record.
Errors	object[]	Shows detailed error information.
Id	string	Returns the validation error ID.
Name	string	Name of the validation error.
Message	string	Description of the validation error.
Errors	object[]	Shows detailed error information.
Id	string	Returns the validation error ID.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Request JSON

Sample	Description	Action
Sample 1	Get status using SubmissionId and RecordIds.

Sample 1

"Form1099W2/status?submissionId=f47ac10b-58cc-4372-a567-0e02b2c3d479&recordIds=cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b"

Response JSON

Sample	Description	Action
200	Success Response - This is a sample response for successful API requests.

Response: 200

{
"SubmissionId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"FormType": "Form1099NEC",
"1099W2Records": [
  {
    "RecordId": "cfd6fe66-ac9f-49f7-b8a3-2d064abeeb9b",
    "FederalStatus": {
      "Code": "FED-002",
      "Status": "ACCEPTED",
      "Message": "Accepted by IRS",
      "StatusTs": "2026-01-25T11:42:00-05:00"
    },
    "StateStatus": [
      {
        "StateCd": "AZ",
        "Code": "ST-001",
        "Status": "ACCEPTED",
        "Message": "Accepted by AZ",
        "StatusTs": "2026-01-25T11:43:00-05:00"
      }
    ],
    "Distribution": {
      "DistributionType": "POSTAL_AND_ONLINE",
      "PostalStatus": {
        "PostalType": "USPS_FIRST_CLASS",
        "Code": "POS-006",
        "Status": "DELIVERED",
        "Message": "Stamped delivered by USPS",
        "StatusTs": "2026-01-30T16:00:00-05:00"
      },
      "OnlineAccessStatus": {
        "Email": "shawn@sample.com",
        "Code": "OA-004",
        "Status": "VIEWED_FORM",
        "Message": "Recipient viewed the form",
        "StatusTs": "2026-01-25T15:00:00-05:00"
      }
    }
  }
],
"Errors": null
}