Transmit
Transmit
POST Form1099SA/Transmit Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | An unique identifier generated by TaxBandits when a 1099 SA return is created. Mention the 1099 SA return's Submission ID that you want to transmit. |
| RecordIds | Guid[] | OptionalAn unique identifier generated by TaxBandits when a 1099 SA return is created. Mention the 1099 SA return's Record ID that you want to transmit. |
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 |
| Form1099SARecords | object | Pulls the Form 1099 SA records with Success and Error statuses. |
| SuccessRecords | object[] | It will show the detailed information about the success status of Form 1099 SA 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 |
| Status | string | Returns the status of the records. |
| StatusTs | string | Date and Time of the Return Transmission |
| StateReturns | object | Returns the state code and return status. |
| StateCode | string | Returns the code of the state. |
| RecordStatus | string | Returns the status of the records. |
| Postal | object | Returns the status and StatusTs of postal mailing service for Form 1099 SA. |
| 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 SA return. |
| string | Email address for whom the online access to be given. | |
| Info | string | Information about the online access service. |
| ScheduleFiling | object | Returns the date of the schedule filing. |
| ScheduledOn | string | Date of the schedule filing to know when the return to be filed to the IRS. |
| Info | string | Information about Schedule Filing service. |
| ErrorRecords | object[] | It will show the detailed information about the error status of Form 1099SA 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
{
"SubmissionId": "556e41eb-0ccb-4aeb-b486-19743d3a1c32",
"RecordIds": [
"11944cac-7aa0-47e8-951c-5454e38cda4e"
]
}
Response JSON
Success Response - This is a sample response for successful API requests.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "556e41eb-0ccb-4aeb-b486-19743d3a1c32",
"Form1099Records": {
"SuccessRecords": [
{
"SequenceId": "001",
"RecordId": "11944cac-7aa0-47e8-951c-5454e38cda4e",
"Status": "Transmitted",
"StatusTs": "2025-01-11 00:27:28 -05:00",
"StateReturns": null,
"OnlineAccess": {
"Status": "ORDER_CREATED",
"Email": "sample1@bodeem.com",
"Info": "Recipient will receive an email with an unique URL to access their form online"
},
"Postal": {
"Status": "RECEIVED",
"StatusTs": "2025-01-11 00:27:28 -05:00",
"Info": null
},
"ScheduleFiling": {
"ScheduledOn": "01/25/2026",
"Info": "The return is scheduled on 01/25/2026"
}
}
],
"ErrorRecords": null
},
"Errors": null
}