Status
Status
GET Form1099DACorrection/Status Request Params
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission |
| RecordId | Guid | Unique identifier of the return. |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code |
| StatusMessage | string | Detailed status message |
| SubmissionId | Guid | Unique identifier of a submission |
| BusinessId | Guid | Unique identifier of a Business. |
| Form1099Type | string | Denotes the type of 1099 form. |
| Form1099Records | object | Pulls Form 1099 DA correction records with Success and Error statuses |
| SuccessRecords | object[] | It will show the detailed information about the success status of Form 1099 DA correction Records |
| SequenceId | string | An unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. |
| PrevReportedRecordId | Guid | Returns the PrevReportedRecordId given in the Request. |
| RecordId | Guid | An unique identifier generated by TaxBandits when a 1099-DA correction return is created. |
| RecipientId | Guid | An unique identifier generated by TaxBandits for a Recipient when a 1099-DA correction return is created. You can use this id for your future reference to Update. |
| FederalReturn | object | Returns the record status and StatusTs of federal return. |
| Status | string | Returns the record status. |
| StatusTs | string | Returns date and time of return created. |
| Info | string | Returns information about the Federal Filing service. |
| StateReturns | object[] | Returns collection of state returns information |
| Postal | object | Returns the status and StatusTs of postal mailing service for Form 1099 DA correction. |
| Status | string | Returns the status of postal order. |
| StatusTs | string | Returns the date and time of the postal order created. |
| Info | string | Returns the information about Postal mailing service. |
| OnlineAccess | object | Returns the Email address for whom the online access to be given and Status of online access. |
| Status | string | Returns status of online access for Form 1099 DA correction return. |
| string | Email address for whom the online access to be given. | |
| Info | string | Information about the online access service. |
| ErrorRecords | object[] | It will show the detailed information about the error status of Form 1099 DA correction Records. |
| SequenceId | string | An unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. |
| RecordId | Guid | 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 1
- Sample 2
Get status with only the SubmissionID
Form1099DACorrection/Status?SubmissionId=573087a5-ac58-49fc-a17c-93dab9f7aa69
Get status with SubmissionID and 2 RecordIDs
Form1099DACorrection/Status?SubmissionId=573087a5-ac58-49fc-a17c-93dab9f7aa69&RecordIds=2d04415e-2365-43c2-bbfb-3c801c7ebd7b,def3591c-7c66-4d15-a8b1-c36f22e90150
Response JSON
- 200
- 300
- 404
Success Response - This is a sample response for successful API requests.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "d810cc56-a871-485e-b5ce-6ba4bae78db0",
"BusinessId": "7ae96ebe-327b-4e51-80fc-6f7601b71f46",
"PayerRef": "Snow14857",
"Form1099Type": "DACORRECTION",
"Form1099Records": {
"SuccessRecords": [
{
"SequenceId": "01",
"PrevReportedRecordId": null,
"RecordId": "7263a0a6-95e8-41a5-b490-b2cbca20f52f",
"RecipientId": "ff55b6a4-a459-4554-8801-b007c0a23f29",
"FederalReturn": {
"Status": "TRANSMITTED",
"StatusTs": "2026-02-09 05:52:39 -05:00",
"Info": null,
"Errors": null
},
"Postal": {
"Status": "RECEIVED",
"StatusTs": "2026-02-09 05:52:39 -05:00",
"Info": null
},
"OnlineAccess": {
"Status": "EMAIL_SENT",
"Email": "james@sample.com",
"Info": null
}
}
],
"ErrorRecords": null
},
"Errors": null
}
Multi-status Response - You'll get the below response when multiple statuses are included.
{
"StatusCode": 300,
"StatusName": "MultiStatus",
"StatusMessage": "Multiple statuses are available for the request",
"SubmissionId": "b9fd5295-66ec-4b86-8099-facbc30859ef",
"BusinessId": "a87f8b3a-6f7c-4140-88a1-9ecb5bfbe282",
"PayerRef": null,
"Form1099Type": "DACORRECTION",
"Form1099Records": {
"SuccessRecords": [
{
"SequenceId": "21",
"PrevReportedRecordId": null,
"RecordId": "6fc275f0-1bd6-405e-90c5-3fa266a0fedf",
"RecipientId": "67e9e7f3-86b6-478c-b1ed-6150c8471666",
"FederalReturn": {
"Status": "CREATED",
"StatusTs": "2025-07-01 06:30:25 -04:00",
"Info": null,
"Errors": null
},
"Postal": {
"Status": "CREATED",
"StatusTs": "2025-07-01 06:30:25 -04:00",
"Info": null
},
"OnlineAccess": {
"Status": "NA",
"Email": null,
"Info": "This Service will be available soon"
}
}
],
"ErrorRecords": [
{
"SequenceId": null,
"RecordId": "67e9e7f3-86b6-478c-b1ed-6150c8471666",
"Errors": [
{
"Id": "F00-100192",
"Name": "RecordId",
"Message": "Invalid RecordId"
}
]
}
]
},
"Errors": [
{
"Id": "F00-100155",
"Name": "Error Records",
"Message": "Some of the records are errored. Please read the Error Records for more details."
}
]
}
Not Found Response - You'll get the below response if your API request contains a record that's not found in our database.
{
"StatusCode": 404,
"StatusName": "NotFound",
"StatusMessage": "The resource you have specified cannot be found",
"SubmissionId": "9d71ae45-df5f-49f7-86f8-e88f54132fa1",
"BusinessId": null,
"PayerRef": null,
"Form1099Type": null,
"Form1099Records": null,
"Errors": [
{
"Id": "F00-100249",
"Name": "NotFound",
"Message": "No records found"
}
]
}