Version: 1.7.3

Create

This endpoint can be used to create a new Form 941. You can create up to 250 returns in a single request.

Your request JSON must include the business details, along with all the required details on the form. When the request is successful, you’ll receive a SubmissionId, which uniquely identifies that form.

What’s new in Form 941 for 2026?

For the 2026 tax year, the IRS has introduced three new lines, such as 15c, 15d, and 15e, to facilitate direct deposit of overpayment refunds. To receive your refund electronically, you can provide your bank routing number (BankRoutingNum), account type (AccountType), and account number (BankAccountNum) in these lines.

Signature Types

If ONLINE SIGN PIN is chosen as the Signature Type, provide the 10-digit signature PIN issued by the IRS.
If FORM 8453 EMP is chosen as the Signature Type, you can complete the signature process in two ways:
- E-signature: Use Form8453EMP endpoints to request and collect the taxpayer’s e-signature via email or secure URL.
- Manual signature: Call the method DownloadForm8453EMP and send the downloaded Form 8453 to the taxpayer. Once the form is signed, upload it back using UploadForm8453EMP.
If ERO is chosen as the Signature Type, then you can provide the taxpayer PIN in TaxPayerPIN.
If REPORTING_AGENT is chosen as the Signature Type, enter the 5-digit RA-PIN issued by the IRS. Reporting agents may also choose the Signature Type as “ONLINE_SIGN PIN” or “FORM_8453 EMP”, if applicable.

All amount fields must be entered with no more than two decimal places. Values containing more than two decimal places will result in an error. This validation applies to all entries, including zero values (for example, 0.000 will trigger an error).

POST Form941/Create

Run in Postman

Request Body

Field	Type	Description
Form941Records	object[]	Object to create 941s
SequenceId	string	A unique number given by an inbound application to identify failed records. Size Range: ..10
ReturnHeader	object	Identifies the supporting details of Form 941.
ReturnType	string	Type of the return to be filed. Enter values like FORM941, FORM941SP. Allowed values "FORM941", "FORM941SP"
TaxYr	string	The Tax year for which Form 941 needs to be filed. Allowed values 2024,2025,2026
Qtr	string	The Quarter for which Form 941 needs to be filed. Allowed values "Q1", "Q2", "Q3", "Q4"
FilingSecurity	object	Optional Object that contains information about the filing details of the return
IPV4	string	IPV4 address of the return
IPV6	string	IPV6 address of the return
IPDate	string	IP date of the return
IPTime	string	IP time of the return
IPTimeZone	string	IP time zone of the retur Allowed values "EST", "CST", "MST", "PST", "AKST", "HST"
CreateDeviceId	string	Created device ID of the return Size Range: 40 Sample Format: A7F3K9Q2M8Z1B6T4X5L0C9D2R8H3N7P1S6W4Y5V0J2
FilingDeviceId	string	Filing device ID of the return Size Range: 40 Sample Format: A7F3K9Q2M8Z1B6T4X5L0C9D2R8H3N7P1S6W4Y5V0J2
Business	object	Business Details
BusinessId	Guid	OptionalUse the unique Business ID (Generated by TaxBandits), you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again.
BusinessNm	string	Name of the business Size Range: ..75
PayerRef	string	Optional An unique identifier for each payer completing their information. This identifier can be used in future references of the payer in the API. Size Range: ..50
TradeNm	string	Optional Name under which the business operates Size Range: ..75
IsEIN	Boolean	When true, identifies the business with an EIN.
EINorSSN	string	When IsEIN is true, use Employer Identification Number (EIN). When IsEIN is false, use Social Security Number (SSN). Size Range: 9-11
Email	string	Email address of the Business Size Range: ..100
ContactNm	string	Name of the person who can be contacted by the IRS Size Range: ..27
Phone	string	Contact number of the business with area code Size Range: 10
PhoneExtn	string	Optional Extension of the business phone number Size Range: ..5
Fax	string	Optional Fax number of the Business Size Range: 10
BusinessType	string	Type of business. Optional for W-2/1099 and mandatory for 94X series Size Range: ..4 Allowed values "ESTE", "PART", "CORP", "EORG", "SPRO" For the description of the Allowed Values , click here
SigningAuthority	object	Details of the person who is authorized to sign the return
Name	string	Name of the signing authority. Size Range: ..35
Phone	string	Phone number of the signing authority. Size Range: 10
BusinessMemberType	string	Business title of the signing authority Size Range: 5..29 Allowed values "CORPORATESECRETARY", "SECRETARYTREASURER", "PARTNER", "GENERALPARTNER", "LIMITEDPARTNER", "LLCMEMBER", "MANAGINGMEMBER", "MANAGER", "TAXMATTERPARTNER", "PRESIDENT", "VICEPRESIDENT", "CORPORATETREASURER", "TREASURER", "ASSISTANTTREASURER", "CHIEFACCOUNTINGOFFICER", "CHIEFEXECUTIVEOFFICER", "CHIEFFINANCIALOFFICER", "TAXOFFICER", "CHIEFOPERATINGOFFICER", "CORPORATEOFFICER", "EXECUTIVEDIRECTOR", "DIRECTOR", "CHAIRMAN", "EXECUTIVEADMINISTRATOR", "RECEIVER", "PASTOR", "ASSISTANTTORELIGIOUSLEADER", "REVEREND", "PRIEST", "MINISTER", "RABBI", "LEADEROFRELIGIOUSORGANIZATION", "SECRETARY", "DIRECTOROFTAXATION", "DIRECTOROFPERSONNEL", "ADMINISTRATOR", "EXECUTOR", "TRUSTEE", "FIDUCIARY", "OWNER", "SOLEPROPRIETOR", "MEMBER", "SOLEMEMBER"
KindOfEmployer	string	Identifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series. Allowed values "FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"
KindOfPayer	string	Kind Of Payer based on the Employer's Federal Tax Return. Allowed values "REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"
IsBusinessTerminated	Boolean	When true, identifies the business as terminated.
IsForeign	Boolean	When true, identifies the business address with a foreign address.
USAddress	object	if IsForeign is false, pass US address of the business
Address1	string	Employer/Payer's US address (street address or post office box of that locality) Size Range: ..46
Address2	string	Optional Employer/Payer's suite or apartment Size Range: ..46
City	string	Employer/Payer's city Size Range: ..50
State	string	Employer/Payer's state Size Range: 2 Allowed values "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"
ZipCd	string	Employer/Payer's zip code. Size Range: 5..10
ForeignAddress	object	if IsForeign is true, pass foreign address of the business
Address1	string	Employer/Payer's foreign address (street address or post office box of that locality). Size Range: ..50
Address2	string	Optional Employer/Payer's suite or apartment Size Range: ..50
City	string	Employer/Payer's city Size Range: ..50
ProvinceOrStateNm	string	Employer/Payer's province or state name Size Range: ..50
Country	string	Employer/Payer's country Size Range: 2 Allowed values "AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"
PostalCd	string	Employer/Payer's postal code Size Range: ..16
IsThirdPartyDesignee	Boolean	When true, your third-party designee is allowed to discuss the return with the IRS.
ThirdPartyDesignee	object	Third Party Designee Details
Name	string	Third Party Designee's name.
Phone	string	Third Party Designee's phone number
PIN	string	A 5 digit PIN (Should not contain all zeroes) used when communicating to the IRS
SignatureDetails	object	Identifies the signature type used in Form 941
SignatureType	string	Type of signature used to sign Form 941 Allowed values "ONLINE_SIGN_PIN", "FORM_8453_EMP", "REPORTING_AGENT" ,"ERO"
OnlineSignaturePIN	object	A 10-digit signature PIN to become an IRS authorized signer.
PIN	string	Sign using a 10 digit PIN received from the IRS. Size Range: 10
ReportingAgentPIN	object	A 5-digit number assigned by the IRS
PIN	string	Sign using a 5 digit PIN received from the IRS. Size Range: 5
TaxPayerPIN	object	Use this option if you have selected ERO under SignatureType..
PIN	string	Any 5-digit PIN given by the Taxpayer on Form 8879-EMP Part II "Taxpayer Declaration and Signature Authorization". Size Range: 5

Allowed values

"AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"

Allowed values

"AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI", "CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA", "MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"

Allowed values

"SOLD", "TRANSFERRED"

Allowed values

"ESTE", "PART", "CORP", "EORG", "SPRO"

Allowed values

Allowed values

| | PostalCd | string | Employer/Payer's postal code.
Size Range: ..16 | | IsSeasonalEmployer | Boolean | When true, identifies if the return is for a seasonal employer and the employer don't have to file a return for every quarter of the year. | | ReturnData | object | Identifies the Form 941 data | | Form941 | object | Form 941, Employer's QUARTERLY Federal Tax Return | | EmployeeCnt | Non negative integer | Gets the number of Employees who has received wages, tips, or other compensation for the pay period including Mar. 12 (Quarter 1), June 12 (Quarter 2), Sept. 12 (Quarter 3), or Dec. 12 (Quarter 4). | | WagesAmt | Decimal | Gets the wages, tips, and other compensation for the Quarter
Size Range: 0-99999999999999.99 | | FedIncomeTaxWHAmt | Decimal | Gets the federal income tax withheld from wages, tips, and other compensation
Size Range: 0-99999999999999.99 | | WagesNotSubjToSSMedcrTaxInd | Boolean | When true, identifies if no wages, tips, and other compensation on line 2 are subject to social security or Medicare tax. | | SocialSecurityTaxCash
WagesAmt_Col1 | Decimal | Gets the taxable social security wages amount. Line 5a Column 1
Size Range: 0-99999999999999.99 | | TaxableSocSecTipsAmt_Col1 | Decimal | Gets the taxable social security tips amount. Line 5b Column 1.
Size Range: 0-99999999999999.99 | | TaxableMedicareWages
TipsAmt_Col1 | Decimal | Gets the taxable medicare wages and tips amount. Line 5c Column 1.
Size Range: 0-99999999999999.99 | | TxblWageTipsSubjAddnl
MedcrAmt_Col1 | Decimal | Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Line 5d Column 1.
Size Range: 0-99999999999999.99 | | SocialSecurityTaxAmt_Col2 | Decimal | Gets the tax on Social Security Wages. Line 5a Column 2.
Size Range: 0-99999999999999.99 | | TaxOnSocialSecurity
TipsAmt_Col2 | Decimal | Gets the tax on Social Security Tips. Line 5b Column 2.
Size Range: 0-99999999999999.99 | | TaxOnMedicareWagesTipsAmt_Col2 | Decimal | Gets the tax on Taxable Medicare Wages and Tips subject to Medicare Amount. Line 5c Column 2.
Size Range: 0-99999999999999.99 | | TaxOnWageTipsSubjAddnl
MedcrAmt_Col2 | Decimal | Gets the tax on Taxable Wages and Tips subject to Additional Medicare Tax withholding amount. Line 5d Column 2.
Size Range: 0-99999999999999.99 | | TotSSMdcrTaxAmt | Decimal | Gets the Total Social Security and Medicare Tax Amount. Line 5e.
Size Range: 0-99999999999999.99 | | TaxOnUnreportedTips3121qAmt | Decimal | Gets the tax due from Section 3121(q) Notice and Demand on line 5f.
Size Range: 0-99999999999999.99 | | TotalTaxBeforeAdjustmentAmt | Decimal | Gets the Total taxes before adjustments by adding the amounts on lines 3, 5e, and 5f on Line 6.
Size Range: -99999999999999.99 to 99999999999999.99 | | CurrentQtrFractionsCentsAmt | Decimal | Gets the amount of current quarter's adjustment for fractions of cents. Line 7.
Size Range: -99999999999999.99 to 99999999999999.99 | | CurrentQuarterSickPaymentAmt | Decimal | Gets the amount of current quarter's adjustment for sick pay. Line 8.
Size Range: -99999999999999.99 to 99999999999999.99 | | CurrQtrTipGrpTermLifeInsAdjAmt | Decimal | Gets the amount of current quarter's adjustments for tips and group-term life insurance. Line 9.
Size Range: -99999999999999.99 to 99999999999999.99 | | TotalTaxAfterAdjustmentAmt | Decimal | Gets the amount of Total taxes after adjustments by adding amount in line 6 through line 9. Line 10.
Size Range: -99999999999999.99 to 99999999999999.99 | | PayrollTaxCreditAmt | Decimal | Gets the amount of qualified small business payroll tax credit for increasing research activities. Line 11.
Size Range: 0-99999999999999.99 | | IsPayrollTaxCredit | Boolean | When true, identifies the Line 11 is greater than zero to determine the amount of qualified small business payroll tax credit for increasing research activities that a business can claim on Form 941. | | Form8974 | object | Information of Form 8974 | | Form8974IncomeTaxDetails | object[] | Collection of Income Tax details | | IncomeTaxPeriodEndDate | string | Gets the ending date of income tax period in Part 1 Column (a). | | IncomeTaxReturnFiledForm | string | Gets the Income tax return filed to elected a qualified small business payroll tax credit on Form 6765. Form 6765 can be attached to Form 1040, 1065, 1120, 1120_F, or 1120S. Part 1 Column (b) | | IncomeTaxReturnFiledDate | string | Gets the income tax return filing date shown in column (b). Part 1 Column (c) | | Form6765EIN | string | Gets the EIN used on Form 6765 if the EIN used on Form 8974 doesn't match with the EIN on Form 6765. Part 1 Column (d)
Size Range: 9 | | Form6765Line44Amt | Decimal | Gets the amount from Form 6765, line 44 or the amount allocated to your EIN if applicable. Part 1 Column (e)
Size Range: 0-99999999999999.99 | | PreviousPeriodRemaining
CreditAmt | Decimal | Gets the amount of credit from column (e) taken on a previous period(s). Part 1 Column (f)
Size Range: 0-99999999999999.99 | | RemainingCredit | Decimal | Gets the total amount of remaining credit by subtracting column (f) from column (e). Part 1 Column (g).
Size Range: 0-99999999999999.99 | | Line7 | number | Gets the total amount from Part 1, line 6(g). Part 2 Line 7.
Size Range: 0-99999999999999.99 | | Line8 | number | Gets the total amount of social security tax on wages from Form 941, line 5a, column 2; Form 943, line 3; or Form 944, line 4a, column 2. Part 2 Line 8.
Size Range: 0-99999999999999.99 | | Line9 | number | Gets the total amount of social security tax on tips from Form 941, line 5b, column 2; or Form 944, line 4b, column 2. Part 2 Line 9.
Size Range: 0-99999999999999.99 | | Line10 | number | Gets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10.
Size Range: 0-99999999999999.99 | | Line11 | number | Gets the amount of line 10 multiplied by 50% (0.50) on line 11. If you're a third-party payer of sick pay or you received a Section 3121(q) Notice and Demand, check the applicable box on line 11.
Size Range: 0-99999999999999.99 | | PayerIndicatorType | string | Identifies if you are a Third-party payer of sick pay or received a Section 3121(q) Notice and Demand

Allowed values

"THIRDPARTYSICKPAYIND", "SECTION3121QIND"

| | Line12 | Decimal | Enter the smaller of Form 8974, line 7 or 11, but not more than $250,000 per quarter.
Size Range: 0-99999999999999.99 | | Line13 | Decimal | Subtract Form 8974, line 12 from line 7. Enter the result on line 13.
Size Range: 0-99999999999999.99 | | Line14 | Decimal | Enter the amount from Form 941, line 5c, column 2. This is the total amount of Medicare tax on wages.
Size Range: 0-99999999999999.99 | | Line15 | Decimal | Enter Form 8974, line 14 multiplied by 50% (0.50) on line 15.
Size Range: 0-99999999999999.99 | | Line16 | Decimal | Enter the smaller of line 13 or 15. This is the total credit against the employer share of Medicare tax.
Size Range: 0-99999999999999.99 | | Line17 | Decimal | Add lines 12 and 16. Also, enter this amount on Form 941, line 11a;
Size Range: 0-99999999999999.99 | | TotTaxAfterAdjustmentAndNonRfdCr | Decimal | Total taxes after adjustments and nonrefundable credits.
Size Range: 0-99999999999999.99 | | TotTaxDepositAmt | Decimal | Gets the total deposits for the quarter, including overpayment amount applied from a prior quarter and overpayments applied by filing Form 941-X, 941-X(PR), 944-X, or 944-X(SP) filed in the current quarter. Line 13.
Size Range: 0-99999999999999.99 | | BalanceDueAmt | Decimal | Gets the difference amount of the balance due if line 12 is more than line 13. Line 14.
Size Range: 0-99999999999999.99 | | OverpaidAmt | Decimal | Gets the difference overpayment amount if line 13 is more than line 12. Line 15.
Size Range: 0-99999999999999.99 | | OverPaymentRecoveryType | string | Gets the overpayment recovery type, whether to have the IRS refund the excess amount or apply it to next return. Check only one box on line 15.

Allowed values

"REFUND", "APPLYTORETURN", "REFUNDDIRECTDEPOSIT"

Allowed values

"Checking" , "Saving"

Allowed values

"EFW", "EFTPS", "CHECK_OR_MO"

Allowed values

"CHECKING", "SAVING"

Allowed values

"MINTAXLIABILITY", "MONTHLY", "SEMIWEEKLY"

Allowed values

"Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28", "Day29", "Day30", "Day31"

Allowed values

Allowed values

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.
Form941Records	object	Pulls the Form 941 records with Success and Error statuses.
SuccessRecords	object[]	It will show the detailed information about the success status of Form 941 Records.
SequenceId	string	A unique number given by an inbound application to identify failed records.
RecordId	Guid	Unique identifier of a record.
BusinessId	Guid	Unique Identifier of the business
PayerRef	string	Unique identifier of the payer.
RecordStatus	string	Returns the status of the records.
CreatedTs	string	Date and time of return created.
UpdatedTs	string	Date and time of return updated.
ErrorRecords	object[]	It will show the detailed information about the error status of Form 941 Records.
RecordId	Guid	Unique identifier of a record.
SequenceId	string	A unique number given by an inbound application to identify failed records.
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.
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.

Payload
Node.js
Python
Java
.NET C#

Request Json

{
"Form941Records": [
    {
        "SequenceId": "001",
        "ReturnHeader": {
            "ReturnType": "FORM941",
            "TaxYr": "2026",
            "Qtr": "Q1",
            "FilingSecurity": {
                "IPV4": "115.240.000.000",
                "IPV6": null,
                "IPDate": "03/04/2026",
                "IPTime": "17:07",
                "IPTimeZone": "EST",
                "CreateDeviceId": "7D11F6D5126AB02D95DA1373C7B5D0F305412345",
                "FilingDeviceId": "11F6D5126AB02D95DA1373C7B5D0F350F4123041"
            },
            "Business": {
                "BusinessId": null,
                "BusinessNm": "PrimeEdge Technologies",
                "TradeNm": null,
                "PayerRef": "Payerref001",
                "IsEIN": true,
                "EINorSSN": "236598959",
                "Email": "joel@sample.com",
                "ContactNm": "Joel Cruz",
                "Phone": "7876417809",
                "PhoneExtn": null,
                "Fax": null,
                "BusinessType": "PART",
                "SigningAuthority": {
                    "Name": "Joel Cruz",
                    "Phone": "787-641-7809",
                    "BusinessMemberType": "OWNER"
                },
                "KindOfEmployer": null,
                "KindOfPayer": null,
                "IsBusinessTerminated": false,
                "IsForeign": false,
                "USAddress": {
                    "Address1": "1 Infinite Loop",
                    "Address2": null,
                    "City": "Cupertino",
                    "State": "CA",
                    "ZipCd": "95014"
                },
                "ForeignAddress": null
            },
            "IsThirdPartyDesignee": false,
            "ThirdPartyDesignee": null,
            "SignatureDetails": {
                "SignatureType": "FORM_8453_EMP",
                "OnlineSignaturePIN": null,
                "ReportingAgentPIN": null,
                "taxPayerPIN": null
            },
            "BusinessStatusDetails": {
                "IsBusinessClosed": false,
                "BusinessClosedDetails": null,
                "IsBusinessTransferred": false,
                "BusinessTransferredDetails": null,
                "IsSeasonalEmployer": false
            }
        },
        "ReturnData": {
            "Form941": {
                "EmployeeCnt": 200,
                "WagesAmt": 1264000.32,
                "FedIncomeTaxWHAmt": 248000.32,
                "WagesNotSubjToSSMedcrTaxInd": false,
                "SocialSecurityTaxCashWagesAmt_Col1": 14502.32,
                "TaxableSocSecTipsAmt_Col1": 1420.36,
                "TaxableMedicareWagesTipsAmt_Col1": 11512.64,
                "TxblWageTipsSubjAddnlMedcrAmt_Col1": 7832.16,
                "SocialSecurityTaxAmt_Col2": 1798.29,
                "TaxOnSocialSecurityTipsAmt_Col2": 176.12,
                "TaxOnMedicareWagesTipsAmt_Col2": 333.87,
                "TaxOnWageTipsSubjAddnlMedcrAmt_Col2": 70.49,
                "TotSSMdcrTaxAmt": 2378.77,
                "TaxOnUnreportedTips3121qAmt": 11204.62,
                "TotalTaxBeforeAdjustmentAmt": 261583.71,
                "CurrentQtrFractionsCentsAmt": 5200.36,
                "CurrentQuarterSickPaymentAmt": 16412.28,
                "CurrQtrTipGrpTermLifeInsAdjAmt": 5420.32,
                "TotalTaxAfterAdjustmentAmt": 288616.67,
                "PayrollTaxCreditAmt": 1154.15,
                "IsPayrollTaxCredit": true,
                "Form8974": {
                    "Form8974IncomeTaxDetails": [
                        {
                            "IncomeTaxPeriodEndDate": "07-07-2025",
                            "IncomeTaxReturnFiledForm": "FORM1065",
                            "IncomeTaxReturnFiledDate": "07-07-2025",
                            "Form6765EIN": "006548956",
                            "Form6765Line44Amt": 5000,
                            "PreviousPeriodRemainingCreditAmt": 100,
                            "RemainingCredit": 4900
                        }
                    ],
                    "Line7": 4900,
                    "Line8": 1798.29,
                    "Line9": 176.12,
                    "Line10": 1974.41,
                    "Line11": 987.21,
                    "PayerIndicatorType": "SECTION3121QIND",
                    "Line12": 987.21,
                    "Line13": 3912.79,
                    "Line14": 333.87,
                    "Line15": 166.94,
                    "Line16": 166.94,
                    "Line17": 1154.15
                },
                "TotTaxAfterAdjustmentAndNonRfdCr": 287462.52,
                "TotTaxDepositAmt": 13248.12,
                "BalanceDueAmt": 274214.40,
                "OverpaidAmt": 0,
                "OverPaymentRecoveryType": null,
                "RefundAccountDetails": {
                    "AccountType": null,
                    "BankRoutingNum": null,
                    "BankAccountNum": null,
                    "Phone": null
                }
            },
            "IRSPaymentType": "EFTPS",
            "IRSPayment": {
                "BankRoutingNum": null,
                "AccountType": null,
                "BankAccountNum": null,
                "Phone": null
            },
            "DepositScheduleType": {
                "DepositorType": "MONTHLY",
                "MonthlyDepositor": {
                    "TaxLiabilityMonth1": 50000.00,
                    "TaxLiabilityMonth2": 187462.52,
                    "TaxLiabilityMonth3": 50000.00
                },
                "SemiWeeklyDepositor": null,
                "TotalQuarterTaxLiabilityAmt": 287462.52
            }
        }
    }
]
}

Response Json

Response	Description	Action
200	Success Response - This is a sample response for successful API requests.

Response: 200

{
  "StatusCode": 200,
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "66c6e0c7-251e-4f00-8a75-14b5656a59db",
  "Form941Records": {
      "SuccessRecords": [
          {
              "SequenceId": "001",
              "BusinessId": "1e26b037-c1db-4d45-957c-7b4836535ca7",
              "PayerRef": "Payerref001",
              "RecordId": "8f85ff98-55ea-4fa9-bc20-7abe02625d14",
              "RecordStatus": "Created",
              "CreatedTs": "2026-03-20 03:50:02 -04:00",
              "UpdatedTs": "2026-03-20 03:50:02 -04:00"
          }
      ],
      "ErrorRecords": null
  },
  "Errors": null
}

W-9/W-8 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Extension Automation

1042-S Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Healthcare Market Research Platforms

Create

Create

Signature Types​

Request Body

Response Body

Response: 200

Signature Types