Skip to main content
Version: 1.7.3

Transmit

Transmit the Form 941 return to the IRS to file your non-employee remuneration. Transmit method should be called only after all the validation errors are cleared. Else, check for the errors and clear them.

Note that, after transmitting the form 941, it cannot be edited or deleted.

The IRS has removed the COVID-related fields in Form 941 for tax year 2024. To refer to the documentation of Form 941 for tax year 2023,click here.

POST Form941/Transmit 
Run in Postman

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission
RecordIdsGuid[]List of record Ids to be transmitted.

Request JSON

Give the SubmissionId and RecordId for the return that has to be transmitted.

{
"SubmissionId": "3c0029c4-15ed-498a-a91f-e5eb3e25964d",
"RecordIds": [
"1e068a7c-6278-4063-bbe3-d8464198b736"
]
}

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.
Form941RecordsobjectPulls the Form 941 records with Success and Error statuses.
    SuccessRecordsobject[]It will show the detailed information about the success status of Form 941 Records.
        SequenceIdstringA unique number given by an inbound application to identify failed records.
        RecordIdGuidUnique identifier of a record.
        RecordStatusstringReturns the status of the records.
        CreatedTsstringDate and time of return created.
        UpdatedTsstringDate and time of return updated.
    ErrorRecordsobject[]It will show the detailed information about the error status of Form 941 Records.
        RecordIdGuidUnique identifier of a record.
        SequenceIdstringA unique number given by an inbound application to identify failed records.
        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 code.
    NamestringName of the validation error.
    MessagestringDescription of the validation error.

Response JSON

The given record is now transmitted, and the RecordStatus will change to “Transmitted”.

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "3c0029c4-15ed-498a-a91f-e5eb3e25964d",
"Form941Records": {
"SuccessRecords": [
{
"SequenceId": "001",
"RecordId": "1e068a7c-6278-4063-bbe3-d8464198b736",
"RecordStatus": "Transmitted",
"CreatedTs": "2024-03-05 00:22:17 -05:00",
"UpdatedTs": "2024-03-05 00:22:48 -05:00"
}
],
"ErrorRecords": null
},
"Errors": null
}