Transmit
Transmits the Form 1099-MISC return to the IRS. You can Transmit a return successfully only if there are no validation errors in the return.
If you want to transmit all the returns under a Submission, pass only the SubmissionId in the Request.
If you are transmitting only particular Returns in a Submission, then pass the SubmissionId along with the specific RecordIds as an array under the SubmissionId.
Note: There will be a response delay considerably if you are passing the SubmissionId and RecordIds.
POST Form1099MISC/Transmit
Request Body
Field | Type | Description |
---|---|---|
SubmissionId | Guid | An unique identifier generated by TaxBandits when a 1099-MISC return is created. Mention the 1099-MISC return's Submission ID that you want to transmit. |
RecordIds | Guid[] | Optional An unique identifier generated by TaxBandits when a 1099-MISC return is created. Mention the 1099-MISC return's Record ID that you want to transmit. |
Request JSON
{
"SubmissionId": "efacde0b-93e4-4327-84f5-f003b14fdc47",
"RecordIds": [
"7629fc38-5a6f-4b51-842e-b3058bc5a94c"
]
}
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-MISC records with Success and Error statuses |
SuccessRecords | object[] | It will show the detailed information about the success status of Form 1099-MISC 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-MISC. |
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-MISC 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-MISC 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 |
Response JSON
Success Response - This is a sample response for successful API requests.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "efacde0b-93e4-4327-84f5-f003b14fdc47",
"Form1099Records": {
"SuccessRecords": [
{
"SequenceId": "001",
"RecordId": "7629fc38-5a6f-4b51-842e-b3058bc5a94c",
"Status": "Transmitted",
"StatusTs": "2021-08-24 02:41:23 -04:00",
"StateReturns": [
{
"StateCode": "PA",
"RecordStatus": "Transmitted"
},
{
"StateCode": "AZ",
"RecordStatus": "Transmitted"
}
],
"OnlineAccess": null ,
"Postal": null
}
],
"ErrorRecords": null
},
"Errors": null
}