Extend your software with TaxBandits IRS E-file API Integration

Skip to main content
Version: 1.7.1

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

FieldTypeDescription
SubmissionIdGuidA 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.
RecordIdsGuid[]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.

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 S records with Success and Error statuses
    SuccessRecordsobject[]It will show the detailed information about the success status of Form 1099 S 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 S 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": "94419089-f9fe-4390-b622-ee06f7682754",  "RecordIds": [    "aabf8859-c07a-4ea1-bdc5-0088cf037f03"  ]}

Response JSON

{   "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"           }       ],       "ErrorRecords": null   },   "Errors": null}