Extend your software with TaxBandits IRS E-file API Integration

Skip to main content
Version: 1.7.0

Transmit

Transmits the Form 1099-R return to the IRS. You can Transmit a return successfully only if there are no validation errors in the return.

POST Form1099R/Transmit

Request Body

FieldTypeDescription
SubmissionIdGuidA unique identifier generated by TaxBandits when a 1099-R return is created. Mention the 1099-R return's Submission ID that you want to transmit.
RecordIdsGuid[]A unique identifier generated by TaxBandits when a 1099-R return is created. Mention the 1099-R return's Record ID that you want to transmit.

Response Body

FieldTypeDescription
StatusCodenumberReturns the HTTP status codes like 200,300 etc.
StatusNamestringName of the status code
StatusMessagestringDetailed status message
SubmissionIdGuidUnique identifier of a submission
Form1099RecordsobjectPulls the Form 1099 R records with Success and Error statuses
    SuccessRecordsobject[]It will show the detailed information about the success status of Form 1099 R Records
        SequenceIdstringA 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.
        RecordIdGuidUnique identifier of a record
        StatusstringReturns the status of the records.
        StatusTsstringDate and Time of the Return Transmission
    ErrorRecordsobject[]It will show the detailed information about the error status of Form 1099 R Records.
        SequenceIdstringA 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.
        RecordIdGuidUnique identifier of a record
        Errorsobject[]Shows detailed error information
            IdstringReturns the validation error Id
            NamestringName of the validation error
            MessagestringDescription of the validation error
Errorsobject[]Shows detailed error information
    IdstringReturns the validation error Id
    NamestringName of the validation error
    MessagestringDescription of the validation error

Request JSON

{
"SubmissionId": "524af29a-a859-46a0-9223-110e02ec4660",
"RecordIds": [
"55f703fc-4456-4ca6-ab5a-004cf714a95f"
]
}

Response JSON

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "524af29a-a859-46a0-9223-110e02ec4660",
"Form1099Records": {
"SuccessRecords": [
{
"SequenceId": "001",
"RecordId": "55f703fc-4456-4ca6-ab5a-004cf714a95f",
"Status": "Transmitted",
"StatusTs": "2021-11-24 08:20:15 -05:00",
"StateReturns": null
}
],
"ErrorRecords": null
},
"Errors": null
}