Version: 1.7.3

ValidateForm

Runs business and data validation checks for 941 SchR forms.

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

POST Form941SCHR/ValidateForm

Request Body

Field	Type	Description
Form941SchRRecords	object[]	Object to create 941SCHRs.
RecordId	Guid	Unique Identifier of a record
Sequence	string	A unique number given by an inbound application to identify failed records.
ReturnHeader	object	Identifies the supporting details of Form 941SCHR
ReturnType	string	Type of the return to be filed. Allowed values: "FORM941SCHR"
MoreClients	Boolean	When MoreClients is true, it allows submission for more than 1000 clients. When MoreClients is false, it allows a maximum of 1000 clients in one submission. Required only for Form 941SCHR.
TaxYr	string	The Tax year for which Form 941 SCH R needs to be filed. Allowed values: "2024"
Qtr	string	The Quarter for which Form 941SCHR 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
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	Optional Name of the person whom the IRS can contact. 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	Optional Name of the signing authority Size Range: ..35
Phone	string	Optional Phone number of the signing authority Size Range: 10
BusinessMemberType	string	Optional 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 country code. 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 941SCHR
SignatureType	string	Type of signature used to sign Form 941SCHR. Allowed values "ONLINE_SIGN_PIN", "FORM_8453_EMP", "PIN_REQUEST", "CPA_SIGN_PIN", "REPORTING_AGENT"
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.
ReportingAgentPIN	object	A 5-digit number assigned by the IRS.
PIN	string	Sign using a 5 digit PIN received from the IRS.
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.
AttachmentNm	string	Name of the Form 8453EMP attachment
Attachment	byte[]	Byte array of Form-8453 pdf.
AttachmentFileType	string	Type of the file Attachment
SignedDate	DateTime	Date and time on which the Form 8453-EMP was signed
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
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	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
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
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 941SCHR and Aggregate Form 941 data.
Form941MainFilerData	object	Form 941 details of the CPEO or the sec. 3504 Agent's employees for Schedule R.
EmployeeCnt	number	Form 941 details of the CPEO or the sec. 3504 Agent's employees for Schedule R. Size Range: 7
WagesAmt	number	Gets the amount of wages, tips, and other compensation.
FedIncomeTaxWHAmt	number	Gets the amount of Federal income tax withheld from wages, tips, and other compensation.
TotSSTax5a5bCol2	number	Sum of Total Social security tax of line 5a and line 5b in Column 2. Size Range: 0-999999999999999.99
TaxOnMedicareWagesTipsAmt_Col2	number	Tax withheld on medicare wages and tips of the main filer. Size Range: 0-999999999999999.99
TotSSMdcrTaxAmt	number	Gets the amount of total social security and medicare taxes.
TaxOnUnreportedTips3121qAmt	number	Gets the amount of the Section 3121(q) Notice and Demand-Tax due on unreported tips. Size Range: 0-999999999999999.99
PayrollTaxCreditAmt	number	Gets the amount of qualified small business payroll tax credit for increasing research.
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.
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.
IncomeTaxReturnFiledDate	string	Gets the income tax return filing date.
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.
Form6765Line44Amt	number	Gets the amount from Form 6765, line 44 or the amount allocated to your EIN if applicable.
PreviousPeriodRemainingCreditAmt	number	Gets the amount of credit taken on a previous period(s).
RemainingCredit	number	Gets the total amount of remaining credit by subtracting
Line7	number	Gets the total amount from Part 1, line 6(g). Part 2 Line 7. Size Range: 0-9999999999999999999.99
Line8	number	Gets the total amount of social security tax on wages from Form 940, line 5a, column 2; Form 943, line 3; or Form 944, line 4a, column 2. Part 2 Line 8. Size Range: 0-9999999999999999999.99
Line9	number	Gets the total amount of social security tax on tips from Form 940, line 5b, column 2; or Form 944, line 4b, column 2. Part 2 Line 9. Size Range: 0-9999999999999999999.99
Line10	number	Gets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10. Size Range: 0-9999999999999999999.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-9999999999999999999.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	number	Gets the credit amount smaller of line 7 or line 11. Size Range: 0-9999999999999999999.99
Line13	number	Subtract Form 8974, line 12 from line 7. Enter the result on line 13 Size Range: 0-99999999999999.99
Line14	number	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	number	Enter Form 8974, line 14 multiplied by 50% (0.50) on line 15. Size Range: 0-99999999999999.99
Line16	number	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	number	Add lines 12 and 16. Also, enter this amount on Form 941, line 11a; Size Range: 0-99999999999999.99
TotTaxAfterAdjustmentAndNonRfdCr	number	Total taxes after adjustments and nonrefundable credits. Size Range: 0-999999999999999.99
TotTaxDepositAmt	number	Gets the amount of total deposits.
Form941ClientDetails	object[]	Collection of Form 941 details of each client for Schedule R
CSeqId	string	A unique sequence number of a client Size Range: ...10
ClientName	string	Client's Name Size Range: ...80
ClientEIN	string	Gets the client's Employer identification number (EIN). Size Range: 9
WagesTypeCd	string	Gets the code type of wages, tips, and other compensation (CPEO Use Only).
EmployeeCnt	number	The total number of employees. Size Range: 7
WagesAmt	number	Gets the amount of wages, tips, and other compensation. Size Range: 0-9999999999999999999.99
FedIncomeTaxWHAmt	number	Gets the amount of federal income tax withheld from wages, tips, and other compensation. Size Range: 0-9999999999999999999.99
TotSSTax5a5bCol2	number	Sum of Total Social security tax of line 5a and line 5b in Column 2. Size Range: 0-9999999999999999999.99
TaxOnMedicareWagesTipsAmt_Col2	number	Tax withheld on medicare wages and tips of the main filer. Size Range: 0-9999999999999999999.99
TotSSMdcrTaxAmt	number	Gets the amount of total social security and medicare taxes.
TaxOnUnreportedTips3121qAmt	number	Gets the amount of the Section 3121(q) Notice and Demand-Tax due on unreported tips. Size Range: 0-999999999999999.99
PayrollTaxCreditAmt	number	Gets the amount of qualified small business payroll tax credit for increasing research.
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)
Form6765Line44Amt	number	Gets the amount from Form 6765, line 44 or the amount allocated to your EIN if applicable. Part 1 Column (e)
PreviousPeriodRemainingCreditAmt	number	Gets the amount of credit from column (e) taken on a previous period(s). Part 1 Column (f)
RemainingCredit	number	Gets the total amount of remaining credit by subtracting column (f) from column (e). Part 1 Column (g)
Line7	number	Gets the total amount from Part 1, line 6(g). Part 2 Line 7. Size Range: 0-9999999999999999999.99
Line8	number	Gets the total amount of social security tax on wages from Form 940, line 5a, column 2; Form 943, line 3; or Form 944, line 4a, column 2. Part 2 Line 8. Size Range: 0-9999999999999999999.99
Line9	number	Gets the total amount of social security tax on tips from Form 940, line 5b, column 2; or Form 944, line 4b, column 2. Part 2 Line 9. Size Range: 0-9999999999999999999.99
Line10	number	Gets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10. Size Range: 0-9999999999999999999.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-9999999999999999999.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	number	Gets the credit amount smaller of line 7 or line 11. Size Range: 0-9999999999999999999.99
Line13	number	Subtract Form 8974, line 12 from line 7. Enter the result on line 13 Size Range: 0-99999999999999.99
Line14	number	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	number	Enter Form 8974, line 14 multiplied by 50% (0.50) on line 15. Size Range: 0-99999999999999.99
Line16	number	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	number	Add lines 12 and 16. Also, enter this amount on Form 941, line 11a; Size Range: 0-99999999999999.99
TotTaxAfterAdjustmentAndNonRfdCr	number	Total taxes after adjustments and nonrefundable credits. Size Range: 0-9999999999999999999.99
TotTaxDepositAmt	number	Gets the amount of total deposits.
CRecordId	Guid	Client Record Identifier.
AggregateForm941Data	object	Aggregate Form 941 (Totals of Clients + the main filer). For Form 941
EmployeeCnt	number	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) Size Range: 0-9999999
WagesAmt	number	Gets the wages, tips, and other compensation for the Quarter Size Range: 0-9999999999999999999.99
FedIncomeTaxWHAmt	number	Gets the federal income tax withheld from wages, tips, and other compensation Size Range: 0-9999999999999999999.99
WagesNotSubjToSSMedcrTaxInd	Boolean	When true, identifies if no wages, tips, and other compensation on line 2 are subject to social security or Medicare tax.
SocialSecurityTaxCashWagesAmt_Col1	number	Gets the taxable social security wages amount. Line 5a Column 1 Size Range: 0-9999999999999999999.99
TaxableSocSecTipsAmt_Col1	number	Gets the taxable social security tips amount. Line 5b Column 1 Size Range: 0-9999999999999999999.99
TaxableMedicareWagesTipsAmt_Col1	number	Gets the taxable medicare wages and tips amount. Line 5c Column 1. Size Range: 0-9999999999999999999.99
TxblWageTipsSubjAddnlMedcrAmt_Col1	number	Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Line 5d Column 1 Size Range: 0-9999999999999999999.99
SocialSecurityTaxAmt_Col2	number	Gets the tax on Social Security Wages. Line 5a Column 2 Size Range: 0-9999999999999999999.99
TaxOnSocialSecurityTipsAmt_Col2	number	Gets the tax on Social Security Tips. Line 5b Column 2 Size Range: 0-9999999999999999999.99
TaxOnMedicareWagesTipsAmt_Col2	number	Gets the tax on Taxable Medicare Wages and Tips subject to Medicare Amount. Line 5c Column 2 Size Range: 0-9999999999999999999.99
TaxOnWageTipsSubjAddnlMedcrAmt_Col2	number	Gets the tax on Taxable Wages and Tips subject to Additional Medicare Tax withholding amount. Line 5d Column 2 Size Range: 0-9999999999999999999.99
TotSSMdcrTaxAmt	number	Gets the Total Social Security and Medicare Tax Amount. Line 5e Size Range: 0-9999999999999999999.99
TaxOnUnreportedTips3121qAmt	number	Gets the tax due from Section 3121(q) Notice and Demand on line 5f Size Range: 0-9999999999999999999.99
TotalTaxBeforeAdjustmentAmt	number	Gets the Total taxes before adjustments by adding the amounts on lines 3, 5e, and 5f on Line 6. Size Range: 0-999999999999999.99
CurrentQtrFractionsCentsAmt	number	Gets the amount of current quarter's adjustment for fractions of cents. Line 7. Size Range: 0-999999999999999.99
CurrentQuarterSickPaymentAmt	number	Gets the amount of current quarter's adjustment for sick pay. Line 8. Size Range: 0-999999999999999.99
CurrQtrTipGrpTermLifeInsAdjAmt	number	Gets the amount of current quarter's adjustments for tips and group-term life insurance. Line 9. Size Range: 0-999999999999999.99
TotalTaxAfterAdjustmentAmt	number	Gets the amount of Total taxes after adjustments by adding amount in line 6 through line 9. Line 10. Size Range: 0-999999999999999.99
PayrollTaxCreditAmt	number	Gets the amount of qualified small business payroll tax credit for increasing research activities. Line 11. Size Range: 0-9999999999999999999.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 8974.
FilerType	string	Gets the Type of the filer. Allowed values "Section 3504 Agent", "CPEO", "Other Third Party Paid Preparer"
TotTaxAfterAdjustmentAndNonRfdCr	number	Total taxes after adjustments and nonrefundable credits. Size Range: 0-9999999999999999999.99
TotTaxDepositAmt	number	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-9999999999999999999.99
BalanceDueAmt	number	Gets the difference amount of the balance due if line 12 is more than line 13. Line 14 Size Range: 0-9999999999999999999.99
OverpaidAmt	number	Gets the difference overpayment amount if line 13 is more than line 12. Line 15. Size Range: 0-9999999999999999999.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.
IRSPaymentType	string	EFW or EFTPS or Check / Money Order
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
AccountType	string	Account Type of EFW payment Allowed values "CHECKING", "SAVING"
BankAccountNum	string	Bank Account Number of EFW payment Size Range: 0...17
Phone	string	Phone of EFW payment Size Range: 10
DepositScheduleType	object	Identifies the Employer's deposit schedule and tax liability for the quarter
DepositorType	string	Type of Deposit Schedule. Values like Minimum Tax Liability, Monthly or Semi Weekly
MonthlyDepositor	object	Line 16, Option 2. Monthly Schedule Depositor
TaxLiabilityMonth1	number	Tax Liability for Month 1 of the filing quarter
TaxLiabilityMonth2	number	Tax Liability for Month 2 of the filing quarter
TaxLiabilityMonth3	number	Tax Liability for Month 3 of the filing quarter
SemiWeeklyDepositor	object	Line 16, Option 3. SemiWeekly Depositor
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	number	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", "Day29", "Day30", "Day31"
Amt	number	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	number	Tax Liability Amount Size Range: 0-99999999999999.99
TotalQuarterTaxLiabilityAmt	number	Total tax liability amount for the quarter. Size Range: 0-99999999999999.99

note

All the amount fields should be rounded to two decimal places. An error will occur if you enter more than two decimal places. The error will apply even if the value is 0.000.

Request JSON

{
    "Form941SchRRecords": [
        {
            "RecordId": null,
            "Sequence": null,
            "ReturnHeader": {
                "ReturnType": "FORM941SCHR",
                "MoreClients": false,
                "TaxYr": "2024",
                "Qtr": "Q4",
                "Business": {
                    "BusinessId": null,
                    "BusinessNm": "Snowdaze LLC",
                    "TradeNm": "Meefto",
                    "IsEIN": true,
                    "EINorSSN": "384798798",
                    "Email": "sample@bodeem.com",
                    "ContactNm": "John",
                    "Phone": "1234567890",
                    "PhoneExtn": null,
                    "Fax": "1234567890",
                    "BusinessType": "CORP",
                    "SigningAuthority": {
                        "Name": "John",
                        "Phone": "1234567890",
                        "BusinessMemberType": "PRESIDENT"
                    },
                    "KindOfEmployer": "FEDERALGOVT",
                    "KindOfPayer": "REGULAR941",
                    "IsBusinessTerminated": false,
                    "IsForeign": false,
                    "USAddress": {
                        "Address1": "1751 Kinsey Rd",
                        "Address2": "Main St",
                        "City": "Dothan",
                        "State": "AL",
                        "ZipCd": "36303"
                    },
                    "ForeignAddress": {
                        "Address1": null,
                        "Address2": null,
                        "City": null,
                        "ProvinceOrStateNm": null,
                        "Country": null,
                        "PostalCd": null
                    }
                },
                "IsThirdPartyDesignee": false,
                "ThirdPartyDesignee": {
                    "Name": null,
                    "Phone": null,
                    "PIN": null
                },
                "SignatureDetails": {
                    "SignatureType": "ONLINE_SIGN_PIN",
                    "OnlineSignaturePIN": {
                        "PIN": "1234567895"
                    },
                    "ReportingAgentPIN": {
                        "PIN": null
                    }
                },
                "BusinessStatusDetails": {
                    "IsBusinessClosed": false,
                    "BusinessClosedDetails": null,
                    "IsBusinessTransferred": false,
                    "BusinessTransferredDetails": {
                        "Name": null,
                        "BusinessChangeType": null,
                        "DateOfChange": null,
                        "NewBusinessType": null,
                        "NewBusinessName": null,
                        "IsForeign": false,
                        "USAddress": null,
                        "ForeignAddress": null
                    },
                    "IsSeasonalEmployer": false
                }
            },
            "ReturnData": {
                "Form941MainFilerData": {
                    "EmployeeCnt": 500,
                    "WagesAmt": 5000,
                    "FedIncomeTaxWHAmt": 1250,
                    "TotSSTax5a5bCol2": 93,
                    "TaxOnMedicareWagesTipsAmt_Col2": 14.5,
                    "TotSSMdcrTaxAmt": 109.75,
                    "TaxOnUnreportedTips3121qAmt": 1000,
                    "PayrollTaxCreditAmt": 107.5,
                    "IsPayrollTaxCredit": true,
                    "Form8974": {
                        "Form8974IncomeTaxDetails": [
                            {
                                "IncomeTaxPeriodEndDate": "07-07-2021",
                                "IncomeTaxReturnFiledForm": "FORM1065",
                                "IncomeTaxReturnFiledDate": "07-07-2021",
                                "Form6765EIN": "006548956",
                                "Form6765Line44Amt": 2189,
                                "PreviousPeriodRemainingCreditAmt": 189,
                                "RemainingCredit": 2000
                            }
                        ],
                        "Line7": 2000,
                        "Line8": 124,
                        "Line9": 62,
                        "Line10": 186,
                        "Line11": 93,
                        "PayerIndicatorType": "THIRDPARTYSICKPAYIND",
                        "Line12": 93,
                        "Line13": 1907,
                        "Line14": 29,
                        "Line15": 14.5,
                        "Line16": 14.5,
                        "Line17": 107.5
                    },
                    "TotTaxAfterAdjustmentAndNonRfdCr": 1698.5,
                    "TotTaxDepositAmt": 198.5
                },
                "Form941ClientDetails": [
                    {
                        "CSeqId": "1",
                        "ClientName": "Snowdaze LLC",
                        "ClientEIN": "002589632",
                        "WagesTypeCd": "A",
                        "EmployeeCnt": 250,
                        "WagesAmt": 2500,
                        "FedIncomeTaxWHAmt": 625,
                        "TotSSTax5a5bCol2": 46.5,
                        "TaxOnMedicareWagesTipsAmt_Col2": 7.25,
                        "TotSSMdcrTaxAmt": 54.87,
                        "TaxOnUnreportedTips3121qAmt": 500,
                        "PayrollTaxCreditAmt": 107.5,
                        "IsPayrollTaxCredit": true,
                        "Form8974": {
                            "Form8974IncomeTaxDetails": [
                                {
                                    "IncomeTaxPeriodEndDate": "07-07-2021",
                                    "IncomeTaxReturnFiledForm": "FORM1065",
                                    "IncomeTaxReturnFiledDate": "07-07-2021",
                                    "Form6765EIN": "006548956",
                                    "Form6765Line44Amt": 2189,
                                    "PreviousPeriodRemainingCreditAmt": 189,
                                    "RemainingCredit": 2000
                                }
                            ],
                        "Line7": 2000,
                        "Line8": 124,
                        "Line9": 62,
                        "Line10": 186,
                        "Line11": 93,
                        "PayerIndicatorType": "THIRDPARTYSICKPAYIND",
                        "Line12": 93,
                        "Line13": 1907,
                        "Line14": 29,
                        "Line15": 14.5,
                        "Line16": 14.5,
                        "Line17": 107.5
                        },
                        "TotTaxAfterAdjustmentAndNonRfdCr": 849.25,
                        "TotTaxDepositAmt": 99.25,
                        "CRecordId": null
                    },
                    {
                        "CSeqId": "2",
                        "ClientName": "MNM LLC",
                        "ClientEIN": "002589232",
                        "WagesTypeCd": "A",
                        "EmployeeCnt": 250,
                        "WagesAmt": 2500,
                        "FedIncomeTaxWHAmt": 625,
                        "TotSSTax5a5bCol2": 46.5,
                        "TaxOnMedicareWagesTipsAmt_Col2": 7.25,
                        "TotSSMdcrTaxAmt": 54.88,
                        "TaxOnUnreportedTips3121qAmt": 500,
                        "PayrollTaxCreditAmt": 107.5,
                        "IsPayrollTaxCredit": true,
                        "Form8974": {
                            "Form8974IncomeTaxDetails": [
                                {
                                    "IncomeTaxPeriodEndDate": "07-07-2021",
                                    "IncomeTaxReturnFiledForm": "FORM1065",
                                    "IncomeTaxReturnFiledDate": "07-07-2021",
                                    "Form6765EIN": "006548956",
                                    "Form6765Line44Amt": 2189,
                                    "PreviousPeriodRemainingCreditAmt": 189,
                                    "RemainingCredit": 2000
                                }
                            ],
                        "Line7": 2000,
                        "Line8": 124,
                        "Line9": 62,
                        "Line10": 186,
                        "Line11": 93,
                        "PayerIndicatorType": "THIRDPARTYSICKPAYIND",
                        "Line12": 93,
                        "Line13": 1907,
                        "Line14": 29,
                        "Line15": 14.5,
                        "Line16": 14.5,
                        "Line17": 107.5
                        },
                        "TotTaxAfterAdjustmentAndNonRfdCr": 849.25,
                        "TotTaxDepositAmt": 99.25,
                        "CRecordId": null
                    }
                ],
                "AggregateForm941Data": {
                    "EmployeeCnt": 1000,
                    "WagesAmt": 10000,
                    "FedIncomeTaxWHAmt": 2500,
                    "WagesNotSubjToSSMedcrTaxInd": false,
                    "SocialSecurityTaxCashWagesAmt_Col1": 1000,
                    "TaxableSocSecTipsAmt_Col1": 500,
                    "TaxableMedicareWagesTipsAmt_Col1": 1000,
                    "TxblWageTipsSubjAddnlMedcrAmt_Col1": 500,
                    "SocialSecurityTaxAmt_Col2": 124,
                    "TaxOnSocialSecurityTipsAmt_Col2": 62,
                    "TaxOnMedicareWagesTipsAmt_Col2": 29,
                    "TaxOnWageTipsSubjAddnlMedcrAmt_Col2": 4.5,
                    "TotSSMdcrTaxAmt": 219.5,
                    "TaxOnUnreportedTips3121qAmt": 2000,
                    "TotalTaxBeforeAdjustmentAmt": 4719.5,
                    "CurrentQtrFractionsCentsAmt": -300,
                    "CurrentQuarterSickPaymentAmt": -300,
                    "CurrQtrTipGrpTermLifeInsAdjAmt": -400,
                    "TotalTaxAfterAdjustmentAmt": 3719.5,
                    "PayrollTaxCreditAmt": 322.5,
                    "IsPayrollTaxCredit": true,
                    "FilerType": "CPEO",
                    "TotTaxAfterAdjustmentAndNonRfdCr": 3397,
                    "TotTaxDepositAmt": 397,
                    "BalanceDueAmt": 3000,
                    "OverpaidAmt": 0,
                    "OverPaymentRecoveryType": null
                },
                "IRSPaymentType": "EFTPS",
                "IRSPayment": {
                    "BankRoutingNum": null,
                    "AccountType": null,
                    "BankAccountNum": null,
                    "Phone": null
                },
                "DepositScheduleType": {
                    "DepositorType": "SEMIWEEKLY",
                    "MonthlyDepositor": null,
                    "SemiWeeklyDepositor": {
                        "ScheduleBMonth1Amt": [
                            {
                                "Day": "Day1",
                                "Amt": "1000.00"
                            }
                        ],
                        "ScheduleBMonth2Amt": [
                            {
                                "Day": "Day3",
                                "Amt": "2000.00"
                            }
                        ],
                        "ScheduleBMonth3Amt": [
                            {
                                "Day": "Day7",
                                "Amt": "397.00"
                            }
                        ]
                    },
                    "TotalQuarterTaxLiabilityAmt": 3397.00
                }
            }
        }
    ]
}

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 Schedule R Records
SequenceId	string	A unique number given by an inbound application to identify failed records.
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.
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",
 "ErrorRecords" : null,
 "Errors": null
}

W-9 Automation

BOIR Automation

TIN Matching

1099 Automation

941/940 Automation

W-2 Automation

ACA Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Supported Forms