Extend your software with TaxBandits IRS E-file API Integration

Skip to main content
Version: 1.6.1

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}