Transmit
Transmits the Form 1099-S return to the IRS. You can Transmit a return successfully only if there are no validation errors in the return.
POST Form1099S/Transmit
Request Body
Field | Type | Description |
---|---|---|
SubmissionId | Guid | A unique identifier generated by TaxBandits when a 1099-S return is created. Mention the 1099-S return's Submission ID that you want to transmit. |
RecordIds | Guid[] | A unique identifier generated by TaxBandits when a 1099-S return is created. Mention the 1099-S return's Record ID that you want to transmit. |
Request JSON
{
"SubmissionId": "94419089-f9fe-4390-b622-ee06f7682754",
"RecordIds": [
"aabf8859-c07a-4ea1-bdc5-0088cf037f03"
]
}
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 |
Form1099Records | object | Pulls the Form 1099-S records with Success and Error statuses |
SuccessRecords | object[] | It will show the detailed information about the success status of Form 1099-S Records |
SequenceId | string | A 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-S. |
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-S 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-S Records. |
SequenceId | string | A 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 |
Response JSON
Success Response - This is a sample response for successful API requests.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "94419089-f9fe-4390-b622-ee06f7682754",
"Form1099Records": {
"SuccessRecords": [
{
"SequenceId": "001",
"RecordId": "aabf8859-c07a-4ea1-bdc5-0088cf037f03",
"Status": "Transmitted",
"StatusTs": "2021-11-24 09:48:24 -05:00",
"StateReturns": null,
"OnlineAccess": null,
"Postal": null
}
],
"ErrorRecords": null
},
"Errors": null
}