Version: 1.7.3

ValidateForm

Use this method to validate your 941-X data with the IRS business rules and field specifications before creating returns in TaxBandits.

POST Form941X/ValidateForm

Request Body

Field	Type	Description
Form941XRecords	object[]	Object to create 941-Xs
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, FORM941SS. Allowed values "FORM941", "FORM941SS"
TaxYr	string	The Tax year for which Form 941 needs to be filed. Allowed values: "2024","2025"
Qtr	string	The Quarter for which Form 941 needs to be filed. Allowed values "Q1", "Q2", "Q3", "Q4"
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
Form8453EMP	object	An alternate option to sign the return using Form 8453 EMP when there is no PIN
BusinessStatusDetails	object	Identifies the status of the Business
IsBusinessClosed	Boolean	When true, identifies the business as terminated or stopped paying wages
BusinessClosedDetails	object	Identifies the Record Keeper details and date on which the Business was closed
Name	string	Name of the Record Keeper Size Range: ..75
FinalDateWagesPaid	DateTime	Final date on which the business last paid the wages
IsForeign	Boolean	When true, identifies if the business has 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
IsBusinessTransferred	Boolean	When true, identifies the business as transferred.
BusinessTransferredDetails	object	Type of Transfer and Record Keeper details
Name	string	Name of the Record Keeper
BusinessChangeType	string	Type of Transfer. Allowed values "SOLD", "TRANSFERRED"
DateOfChange	DateTime	Date of Sale / Transfer
NewBusinessType	string	New Business Type of the transferred business Allowed values "ESTE", "PART", "CORP", "EORG", "SPRO"
NewBusinessName	string	New Business Name of the transferred business
IsForeign	Boolean	When true, identifies if the business has 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	State code of the employer/payer. Refer Static values. 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 country code. Refer Static values. 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
ReturnData	object	Identifies the Form 941-X data
Form941X	object	Form 941-X, Adjusted Employer’s QUARTERLY Federal Tax Return or Claim for Refund
TypeOfError	string	Gets the type of error to be corrected. Allowed values "ADJUSTED", "CLAIM"
Certifications	object	Certifications on Form W-2 filing status, Adjustments and Claims declarations
Is3FiledW2W2c	Boolean	When true, identifies that the Form W-2 has been already filed or will be filed by the employer
Is4aRpdOrReimb	Boolean	When true, identifies that the employer has reimbursed for overcollected federal income tax, Additional Medicare Tax, social security tax, and Medicare tax for the current year and prior years, but has not claimed or rejected any refunds or credits.
Is4bAdjEmplShr	Boolean	When true, identifies that the adjustment of social security and Medicare tax is for the employer's share, but affected employees have not claimed or declined refunds or credits.
Is4cAdjNotWth	Boolean	When true, identifies that the adjustment pertains to unwithheld federal income tax, social security tax, Medicare tax, or Additional Medicare Tax from employee wages.
Is5aRpdReimb	Boolean	When true, identifies that the employer reimbursed affected employees for overcollected social security and Medicare taxes, but they declined to claim refunds or credits for prior years' claims.
Is5bWrttnCnsnt	Boolean	When true, identifies that the employer has written consent from affected employees to file a claim for social security and Medicare tax, but has also received a statement stating they have not claimed or rejected the claim.
Is5cClmEmplShr	Boolean	When true, identifies that the claim for social security and Medicare tax is for the employer's share, but affected employees have not provided written consent or statements stating they haven't claimed or rejected the claim.
Is5dClmNotWth	Boolean	When true, identifies that the claim pertains to unwithheld federal income tax, social security tax, Medicare tax, or Additional Medicare Tax from employee wages.
TotalCorrectionAmt	object	Identifies total corrected amount (column1)
WagesAmt	Decimal	Gets the amount of wages, tips, and other compensation. Form 941, line 2 Size Range: 0-9999999999999999999.99
FedIncomeTaxWHAmt	Decimal	Gets the amount of federal income tax withheld from wages, tips, and other compensation. Form 941, line 3 Size Range: 0-9999999999999999999.99
SocialSecurityTaxCashWagesAmt	Decimal	Gets the taxable social security wages amount. Form 941 or 941-SS, line 5a, Column 1. Size Range: 0-9999999999999999999.99
TaxableSocSecTipsAmt	Decimal	Gets the taxable social security tips amount. Form 941 or 941-SS, line 5b, Column 1. Size Range: 0-9999999999999999999.99
TaxableMedicareWagesTipsAmt	Decimal	Gets the taxable medicare wages and tips amount. Form 941 or 941-SS, line 5c, Column 1. Size Range: 0-9999999999999999999.99
TxblWageTipsSubjAddnlMedcrAmt	Decimal	Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Form 941 or 941-SS, line 5d. Size Range: 0-9999999999999999999.99
TaxOnUnreportedTips3121qAmt	Decimal	Gets the tax due from Section 3121(q) Notice and Demand on Form 941 or 941-SS, line 5f. Size Range: 0-9999999999999999999.99
TaxAdjustmentAmt	Decimal	Gets the combined value of lines 7, 8 and 9 of Form 941 or 941-SS. Size Range: 0-9999999999999999999.99
PayrollTaxCreditAmt	Decimal	Gets the amount of qualified small business payroll tax credit for increasing research activities. Form 941 line 11 or 941-SS line 11a. Size Range: 0-99999999999999.99
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
PreviousPeriodRemainingCreditAmt	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
SplAddnlWagesFedIncomeTaxAmt	Decimal	Gets the special addition to wages for federal income tax. Size Range: 0-99999999999999.99
SplAddnlWagesSocialSecurityTaxAmt	Decimal	Gets the special addition to wages for social security taxes. Size Range: 0-99999999999999.99
SplAddnlWagesMedcrTaxAmt	Decimal	Gets the special addition to wages for medicare taxes. Size Range: 0-99999999999999.99
SplAddnlWagesAddnlMedcrTaxAmt	Decimal	Gets the special addition to wages for additional medicare tax. Size Range: 0-99999999999999.99
OriginallyReportedOrPrevCorrection	object	Identifies amount originally reported or as previously corrected (column2)
WagesAmt	Decimal	Gets the originally reported amount of wages, tips, and other compensation. Form 941, line 2 Size Range: 0-9999999999999999999.99
FedIncomeTaxWHAmt	Decimal	Gets the originally reported amount of federal income tax withheld from wages, tips, and other compensation. Form 941, line 3 Size Range: 0-9999999999999999999.99
SocialSecurityTaxCashWagesAmt	Decimal	Gets the originally reported taxable social security wages amount. Form 941 or 941-SS, line 5a, Column 1. Size Range: 0-9999999999999999999.99
TaxableSocSecTipsAmt	Decimal	Gets the originally reported taxable social security tips amount. Form 941 or 941-SS, line 5b, Column 1. Size Range: 0-9999999999999999999.99
TaxableMedicareWagesTipsAmt	Decimal	Gets the originally reported taxable medicare wages and tips amount. Form 941 or 941-SS, line 5c, Column 1. Size Range: 0-9999999999999999999.99
TxblWageTipsSubjAddnlMedcrAmt	Decimal	Gets the originally reported taxable wages and tips subject to additional Medicare Tax withholding amount. Form 941 or 941-SS, line 5d. Size Range: 0-9999999999999999999.99
TaxOnUnreportedTips3121qAmt	Decimal	Gets the originally reported tax due from Section 3121(q) Notice and Demand on Form 941 or 941-SS, line 5f. Size Range: 0-9999999999999999999.99
TaxAdjustmentAmt	Decimal	Gets the originally reported combined value of lines 7, 8 and 9 of Form 941 or 941-SS. Size Range: 0-9999999999999999999.99
PayrollTaxCreditAmt	Decimal	Gets the originally reported amount of qualified small business payroll tax credit for increasing research activities. Form 941 line 11 or 941-SS line 11a. Size Range: 0-99999999999999.99
SplAddnlWagesFedIncomeTaxAmt	Decimal	Gets the originally reported special addition to wages for federal income tax. Size Range: 0-99999999999999.99
SplAddnlWagesSocialSecurityTaxAmt	Decimal	Gets the originally reported special addition to wages for social security taxes. Size Range: 0-99999999999999.99
SplAddnlWagesMedcrTaxAmt	Decimal	Gets the originally reported special addition to wages for medicare taxes. Size Range: 0-99999999999999.99
SplAddnlWagesAddnlMedcrTaxAmt	Decimal	Gets the originally reported special addition to wages for additional medicare tax. Size Range: 0-99999999999999.99
CorrectionReportedDifference	object	Identifies the difference between total corrected amount (column 1) and amount originally reported or as previously corrected (column2).
WagesAmt	Decimal	Gets the amount of wages, tips, and other compensation. Form 941, line 2. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
FedIncomeTaxWHAmt	Decimal	Gets the amount of federal income tax withheld from wages, tips, and other compensation. Form 941, line 3 Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
SocialSecurityTaxCashWagesAmt	Decimal	Gets the taxable social security wages amount. Form 941 or 941-SS, line 5a, Column 1. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
TaxableSocSecTipsAmt	Decimal	Gets the taxable social security tips amount. Form 941 or 941-SS, line 5b, Column 1. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
TaxableMedicareWagesTipsAmt	Decimal	Gets the taxable medicare wages and tips amount. Form 941 or 941-SS, line 5c, Column 1. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
TxblWageTipsSubjAddnlMedcrAmt	Decimal	Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Form 941 or 941-SS, line 5d. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
TaxOnUnreportedTips3121qAmt	Decimal	Gets the tax due from Section 3121(q) Notice and Demand on Form 941 or 941-SS, line 5f. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
TaxAdjustmentAmt	Decimal	Gets the combined value of lines 7, 8 and 9 of Form 941 or 941-SS. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
PayrollTaxCreditAmt	Decimal	Gets the amount of qualified small business payroll tax credit for increasing research activities. Form 941 line 11 or 941-SS line 11a. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
SplAddnlWagesFedIncomeTaxAmt	Decimal	Gets the special addition to wages for federal income tax. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
SplAddnlWagesSocialSecurityTaxAmt	Decimal	Gets the special addition to wages for social security taxes. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
SplAddnlWagesMedcrTaxAmt	Decimal	Gets the special addition to wages for medicare taxes. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
SplAddnlWagesAddnlMedcrTaxAmt	Decimal	Gets the special addition to wages for additional medicare tax. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign
TaxCorrection	object	Identifies the tax corrected amounts (column 4)
FedIncomeTaxWHAmt	Decimal	Gets the corrected amount of federal income tax withheld from wages, tips, and other compensation. Form 941, line 3 Size Range: -9999999999999999999.99-9999999999999999999.99
SocialSecurityTaxCashWagesAmt	Decimal	Gets the corrected taxable social security wages amount. Form 941 or 941-SS, line 5a, Column 1. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If you're correcting your employer share only use 0.062 to calculate the corrected taxable social security wages amount else use 0.124
TaxableSocSecTipsAmt	Decimal	Gets the corrected taxable social security tips amount. Form 941 or 941-SS, line 5b, Column 1. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If you're correcting your employer share only use 0.062 to calculate the corrected taxable social security wages amount else use 0.124
TaxableMedicareWagesTipsAmt	Decimal	Gets the corrected taxable medicare wages and tips amount. Form 941 or 941-SS, line 5c, Column 1. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If you're correcting your employer share only use 0.0145 to calculate the corrected taxable social security wages amount else use 0.029
TxblWageTipsSubjAddnlMedcrAmt	Decimal	Gets the corrected taxable wages and tips subject to additional Medicare Tax withholding amount. Form 941 or 941-SS, line 5d. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: Certain wages and tips reported in CorrectionReportedDifference shouldn’t be multiplied by 0.009. Refer
TaxOnUnreportedTips3121qAmt	Decimal	Gets the corrected tax due from Section 3121(q) Notice and Demand on Form 941 or 941-SS, line 5f. Size Range: -9999999999999999999.99-9999999999999999999.99
TaxAdjustmentAmt	Decimal	Gets the corrected combined value of lines 7, 8 and 9 of Form 941 or 941-SS. Size Range: -9999999999999999999.99-9999999999999999999.99
PayrollTaxCreditAmt	Decimal	Gets the corrected amount of qualified small business payroll tax credit for increasing research activities. Form 941 line 11 or 941-SS line 11a. Size Range: -9999999999999999999.99-9999999999999999999.99
SplAddnlWagesFedIncomeTaxAmt	Decimal	Gets the corrected special addition to wages for federal income tax. Size Range: -9999999999999999999.99-9999999999999999999.99
SplAddnlWagesSocialSecurityTaxAmt	Decimal	Gets the corrected special addition to wages for social security taxes. Size Range: -9999999999999999999.99-9999999999999999999.99
SplAddnlWagesMedcrTaxAmt	Decimal	Gets the corrected special addition to wages for medicare taxes. Size Range: -9999999999999999999.99-9999999999999999999.99
SplAddnlWagesAddnlMedcrTaxAmt	Decimal	Gets the corrected special addition to wages for additional medicare tax. Size Range: -9999999999999999999.99-9999999999999999999.99
CombinedTaxAmt	Decimal	Gets the combined total of TaxCorrection object Size Range: -9999999999999999999.99-9999999999999999999.99
TotalAmt	Decimal	Gets the total tax amount. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If TotalAmt is greater than zero then IRSPayment and AmndScheduleB is required
IsCorrectionUndrReportedOvrReporteddAmt	Boolean	If true identifies that corrections reported include both underreported and overreported amounts
IsCorrectionReclassWrks	Boolean	If true identifies that corrections involve reclassified workers
CorrectionExpln	string	Gets the detailed explanation of corrections are determined Size Range: 10000
IRSPaymentType	string	Payment type to make payments to the IRS. Choose from EFW, EFTPS, Check or Money Order Allowed values "EFW", "EFTPS", "CHECK_OR_MO"
IRSPayment	object	Identifies the details of Electronic Funds Withdrawal (EFW) if paying the balance due along with the return
BankRoutingNum	string	Bank Routing Number of EFW payment Size Range: 9
AccountType	string	Account Type of EFW payment Allowed values CHECKING, "SAVING"
BankAccountNum	string	Bank Account Number of EFW payment Size Range: ..17
Phone	string	Phone of EFW payment Size Range: 10
AmndScheduleB	object	Deposit schedule of the amount to be reported to IRS
ScheduleBMonth1Amt	object[]	Tax Liability for Month 1 of the filing quarter in Form Schedule B.
Day	string	Tax Liability Day of the month. 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"
Amt	Decimal	Tax Liability Amount. Size Range: 0-99999999999999.99
ScheduleBMonth2Amt	object[]	Tax Liability for Month 2 of the filing quarter in Form Schedule B.
Day	string	Tax Liability Day of the month. 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"
Amt	Decimal	Tax Liability Amount. Size Range: 0-99999999999999.99
ScheduleBMonth3Amt	object[]	Tax Liability for Month 3 of the filing quarter in Form Schedule B.
Day	string	Tax Liability Day of the month. 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"
Amt	Decimal	Tax Liability Amount. Size Range: 0-99999999999999.99
TotalQuarterTaxLiabilityAmt	Decimal	Total tax liability amount for the quarter. Size Range: 0-99999999999999.99 Note: TotalQuarterTaxLiabilityAmt should be equal to TotalAmt only if TotalAmt is greater than zero

Request JSON

{
    "Form941XRecords": [
        {
            "SequenceId": "002",
            "ReturnHeader": {
                "ReturnType": "FORM941X",
                "TaxYr": "2024",
                "Qtr": "Q2",
                "ErrorsDisDate": "08/01/2024",
                "Business": {
                    "BusinessId": null,
                    "BusinessNm": "SnowDaze LLC",
                    "TradeNm": "Icecreams",
                    "FirstNm": null,
                    "MiddleNm": null,
                    "LastNm": null,
                    "Suffix": null,
                    "IsEIN": true,
                    "EINorSSN": "002356895",
                    "Email": "joel@sample.com",
                    "ContactNm": "Joel Cruz",
                    "Phone": "787-641-7809",
                    "PhoneExtn": "12345",
                    "Fax": null,
                    "BusinessType": "CORP",
                    "SigningAuthority": {
                        "Name": "Joel Cruz",
                        "Phone": "7876417809",
                        "BusinessMemberType": "TAXOFFICER"
                    },
                    "KindOfEmployer": null,
                    "KindOfPayer": null,
                    "IsBusinessTerminated": false,
                    "IsForeign": false,
                    "USAddress": {
                        "Address1": "71 st nicholas drive",
                        "Address2": null,
                        "City": "Northpole",
                        "State": "AK",
                        "ZipCd": "99705"
                    },
                    "ForeignAddress": null
                },
                "SignatureDetails": {
                    "SignatureType": "ONLINE_SIGN_PIN",
                    "OnlineSignaturePIN": {
                        "PIN": "2136558945"
                    },
                    "ReportingAgentPIN": {
                        "PIN": null
                    },
                    "taxPayerPIN": {
                        "PIN": null
                    },
                    "Form8453EMP": null
                }
            },
            "ReturnData": {
                "Form941X": {
                    "TypeOfError": "ADJUSTED",
                    "Certifications": {
                        "Is3FiledW2W2c": true,
                        "Is4aRpdOrReimb": false,
                        "Is4bAdjEmplShr": false,
                        "Is4cAdjNotWth": false,
                        "Is5aRpdReimb": false,
                        "Is5bWrttnCnsnt": false,
                        "Is5cClmEmplShr": false,
                        "Is5dClmNotWth": false
                    },
                    "TotalCorrectionAmt": {
                        "WagesAmt": 3000,
                        "FedIncomeTaxWHAmt": 3000,
                        "SocialSecurityTaxCashWagesAmt": 1000,
                        "TaxableSocSecTipsAmt": 176.12,
                        "TaxableMedicareWagesTipsAmt": 333.87,
                        "TxblWageTipsSubjAddnlMedcrAmt": 3500,
                        "TaxOnUnreportedTips3121qAmt": 5000,
                        "TaxAdjustmentAmt": 3000,
                        "PayrollTaxCreditAmt": 239.86,
                        "Form8974": {
                            "Form8974IncomeTaxDetails": [
                                {
                                    "IncomeTaxPeriodEndDate": "07-07-2022",
                                    "IncomeTaxReturnFiledForm": "FORM1065",
                                    "IncomeTaxReturnFiledDate": "07-07-2022",
                                    "Form6765EIN": "006548957",
                                    "Form6765Line44Amt": 5000,
                                    "PreviousPeriodRemainingCreditAmt": 100,
                                    "RemainingCredit": 4900
                                }
                            ],
                            "Line7": 4900,
                            "Line8": 124,
                            "Line9": 21.84,
                            "Line10": 145.84,
                            "Line11": 72.92,
                            "PayerIndicatorType": "SECTION3121QIND",
                            "Line12": 72.92,
                            "Line13": 4827.08,
                            "Line14": 333.87,
                            "Line15": 166.94,
                            "Line16": 166.94,
                            "Line17": 239.86
                        },
                        "SplAddnlWagesFedIncomeTaxAmt": 1000, //line19
                        "SplAddnlWagesSocialSecurityTaxAmt": 1500, //line20
                        "SplAddnlWagesMedcrTaxAmt": 2300, //line21
                        "SplAddnlWagesAddnlMedcrTaxAmt": 1700 // line22
                    },
                    "OriginallyReportedOrPrevCorrection": {
                        "WagesAmt": 3050,
                        "FedIncomeTaxWHAmt": 2000,
                        "SocialSecurityTaxCashWagesAmt": 500,
                        "TaxableSocSecTipsAmt": 76.12,
                        "TaxableMedicareWagesTipsAmt": 33.87,
                        "TxblWageTipsSubjAddnlMedcrAmt": 1500,
                        "TaxOnUnreportedTips3121qAmt": 4000,
                        "TaxAdjustmentAmt": 2000,
                        "PayrollTaxCreditAmt": 100.86,
                        "SplAddnlWagesFedIncomeTaxAmt": 500,
                        "SplAddnlWagesSocialSecurityTaxAmt": 1000,
                        "SplAddnlWagesMedcrTaxAmt": 300,
                        "SplAddnlWagesAddnlMedcrTaxAmt": 700
                    },
                    "CorrectionReportedDifference": {
                        "WagesAmt": -50,
                        "FedIncomeTaxWHAmt": 1000,
                        "SocialSecurityTaxCashWagesAmt": 500,
                        "TaxableSocSecTipsAmt": 100,
                        "TaxableMedicareWagesTipsAmt": 300,
                        "TxblWageTipsSubjAddnlMedcrAmt": 2000,
                        "TaxOnUnreportedTips3121qAmt": 1000,
                        "TaxAdjustmentAmt": 1000,
                        "PayrollTaxCreditAmt": 139,
                        "SplAddnlWagesFedIncomeTaxAmt": 500,
                        "SplAddnlWagesSocialSecurityTaxAmt": 500,
                        "SplAddnlWagesMedcrTaxAmt": 2000,
                        "SplAddnlWagesAddnlMedcrTaxAmt": 1000
                    },
                    "TaxCorrection": {
                        "FedIncomeTaxWHAmt": 1000,
                        "SocialSecurityTaxCashWagesAmt": 62,
                        "TaxableSocSecTipsAmt": 12.4,
                        "TaxableMedicareWagesTipsAmt": 8.7,
                        "TxblWageTipsSubjAddnlMedcrAmt": 3500,
                        "TaxOnUnreportedTips3121qAmt": 1000,
                        "TaxAdjustmentAmt": 1000,
                        "PayrollTaxCreditAmt": -139,
                        "SplAddnlWagesFedIncomeTaxAmt": 7.5,
                        "SplAddnlWagesSocialSecurityTaxAmt": 37.2,
                        "SplAddnlWagesMedcrTaxAmt": 34.8,
                        "SplAddnlWagesAddnlMedcrTaxAmt": 1.8
                    },
                    "CombinedTaxAmt": 6525.4,
                    "TotalAmt": 6525.4,
                    "IsCorrectionUndrReportedOvrReporteddAmt": false,
                    "IsCorrectionReclassWrks": false,
                    "CorrectionExpln": "The adjustments are solely for the employer's share of social security and Medicare taxes because either the affected employees could not be located or they did not provide written statements confirming they haven't and won't claim a refund or credit for the overcollection"
                },
                "IRSPaymentType": "EFTPS",
                "IRSPayment": {
                    "BankRoutingNum": null,
                    "AccountType": null,
                    "BankAccountNum": null,
                    "Phone": null
                },
                "AmndScheduleB": {
                    "ScheduleBMonth1Amt": [
                        {
                            "Day": "DAY1",
                            "Amt": 200000
                        },
                        {
                            "Day": "DAY15",
                            "Amt": 87462.52
                        }
                    ],
                    "ScheduleBMonth2Amt": null,
                    "ScheduleBMonth3Amt": null,
                    "TotalQuarterTaxLiabilityAmt": 287462.52
                }
            }
        }
    ]
}

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.
ErrorRecords	object[]	It will show the detailed information about the error status of Form 941 -X Records.
SequenceId	string	Shows detailed error information.
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 code.
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",
    "ErrorRecords": null,
    "Errors": null
}

W-9 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Supported Forms

Request Body

Request JSON

Response Body

Response JSON