Skip to main content
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  
Run in Postman

Request Body

FieldTypeDescription
Form941SchRRecordsobject[]Object to create 941SCHRs.
    RecordIdGuidUnique Identifier of a record
    SequencestringA unique number given by an inbound application to identify failed records.
    ReturnHeaderobjectIdentifies the supporting details of Form 941SCHR
        ReturnTypestringType of the return to be filed.
Allowed values: "FORM941SCHR"
        MoreClientsBooleanWhen 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.
        TaxYrstringThe Tax year for which Form 941 SCH R needs to be filed.
Allowed values: "2024"
        QtrstringThe Quarter for which Form 941SCHR needs to be filed.
Allowed values

"Q1", "Q2", "Q3", "Q4"

        BusinessobjectBusiness Details
            BusinessIdGuidOptionalUse 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.
            BusinessNmstringName of the business
Size Range: ..75
            TradeNmstringOptional Name under which the business operates
Size Range: ..75
            IsEINBooleanWhen true, identifies the business with an EIN.
            EINorSSNstringWhen IsEIN is true, use Employer Identification Number (EIN). When IsEIN is false, use Social Security Number (SSN)
Size Range: 9-11
            EmailstringEmail address of the Business
Size Range: ..100
            ContactNmstringOptional Name of the person whom the IRS can contact.
Size Range: ..27
            PhonestringContact number of the business with area code
Size Range: 10
            PhoneExtnstringOptional Extension of the business phone number
Size Range: ..5
            FaxstringOptional Fax number of the Business
Size Range: 10
            BusinessTypestringType 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
            SigningAuthorityobjectDetails of the person who is authorized to sign the return
                NamestringOptional Name of the signing authority
Size Range: ..35
                PhonestringOptional Phone number of the signing authority
Size Range: 10
                BusinessMemberTypestringOptional 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"

            KindOfEmployerstringIdentifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series.
Allowed values

"FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"

            KindOfPayerstringKind Of Payer based on the Employer's Federal Tax Return.
Allowed values

"REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"

            IsBusinessTerminatedBooleanWhen true, identifies the business as terminated.
            IsForeignBooleanWhen true, identifies the business address with a foreign address.
            USAddressobjectif IsForeign is false, pass US address of the business.
                Address1stringEmployer/Payer's US address (street address or post office box of that locality)
Size Range: ..35
                Address2stringOptional Employer/Payer's suite or apartment
Size Range: ..35
                CitystringEmployer/Payer's city
Size Range: ..27
                StatestringEmployer/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"

                ZipCdstringEmployer/Payer's zip code.
Size Range: 5..10
            ForeignAddressobjectif IsForeign is true, pass foreign address of the business.
                Address1stringEmployer/Payer's foreign address (street address or post office box of that locality)
Size Range: ..35
                Address2stringOptional Employer/Payer's suite or apartment.
Size Range: ..35
                CitystringEmployer/Payer's city.
Size Range: ..27
                ProvinceOrStateNmstringEmployer/Payer's province or state name.
Size Range: ..30
                CountrystringEmployer/Payer country code.
Size Range: 2
Allowed values

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

                PostalCdstringEmployer/Payer's postal code
        IsThirdPartyDesigneeBooleanWhen true, your third-party designee is allowed to discuss the return with the IRS.
        ThirdPartyDesigneeobjectThird Party Designee Details
            NamestringThird Party Designee's name.
            PhonestringThird Party Designee's phone number.
            PINstringA 5 digit PIN (Should not contain all zeroes) used when communicating to the IRS.
        SignatureDetailsobjectIdentifies the signature type used in Form 941SCHR
            SignatureTypestringType of signature used to sign Form 941SCHR.
Allowed values

"ONLINE_SIGN_PIN", "FORM_8453_EMP", "PIN_REQUEST", "CPA_SIGN_PIN", "REPORTING_AGENT"

            OnlineSignaturePINobjectA 10-digit signature PIN to become an IRS authorized signer.
                PINstringSign using a 10 digit PIN received from the IRS.
            ReportingAgentPINobjectA 5-digit number assigned by the IRS.
                PINstringSign using a 5 digit PIN received from the IRS.
            TaxPayerPINobjectUse this option if you have selected ERO under SignatureType.
                PINstringAny 5-digit PIN given by the Taxpayer on Form 8879-EMP Part II "Taxpayer Declaration and Signature Authorization".
Size Range: 5
            Form8453EMPobjectAn alternate option to sign the return using Form 8453 EMP when there is no PIN.
                AttachmentNmstringName of the Form 8453EMP attachment
                Attachmentbyte[]Byte array of Form-8453 pdf.
                AttachmentFileTypestringType of the file Attachment
                SignedDateDateTimeDate and time on which the Form 8453-EMP was signed
        BusinessStatusDetailsobjectIdentifies the status of the Business
            IsBusinessClosedBooleanWhen true, identifies the business as terminated or stopped paying wages
            BusinessClosedDetailsobjectIdentifies the Record Keeper details and date on which the Business was closed
                NamestringName of the Record Keeper
                FinalDateWagesPaidDateTimeFinal date on which the business last paid the wages
                IsForeignBooleanWhen true, identifies if the business has a foreign address.
                USAddressobjectif IsForeign is false, pass US address of the business
                    Address1stringEmployer/Payer's US address (street address or post office box of that locality)
Size Range: ..35
                    Address2stringOptional Employer/Payer's suite or apartment
Size Range: ..35
                    CitystringEmployer/Payer's city
Size Range: ..27
                    StatestringState 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"

                    ZipCdstringEmployer/Payer's zip code.
Size Range: 5..10
                ForeignAddressobjectif IsForeign is true, pass foreign address of the business
                    Address1stringEmployer/Payer's foreign address (street address or post office box of that locality)
Size Range: ..35
                    Address2stringOptional Employer/Payer's suite or apartment
Size Range: ..35
                    CitystringEmployer/Payer's city
Size Range: ..27
                    ProvinceOrStateNmstringEmployer/Payer's province or state name
Size Range: ..30
                    CountrystringEmployer/Payer country code. Refer Static values.
Size Range: 2
Allowed values

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

                    PostalCdstringEmployer/Payer's postal code.
            IsBusinessTransferredBooleanWhen true, identifies the business as transferred.
            BusinessTransferredDetailsobjectType of Transfer and Record Keeper details
                NamestringName of the Record Keeper
                BusinessChangeTypestringType of Transfer.
Allowed values

"SOLD", "TRANSFERRED"

                DateOfChangeDateTimeDate of Sale / Transfer
                NewBusinessTypestringNew Business Type of the transferred business
Allowed values

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

                NewBusinessNamestringNew Business Name of the transferred business
                IsForeignBooleanWhen true, identifies if the business has a foreign address.
                USAddressobjectif IsForeign is false, pass US address of the business
                    Address1stringEmployer/Payer's US address (street address or post office box of that locality)
Size Range: ..35
                    Address2stringOptional Employer/Payer's suite or apartment
Size Range: ..35
                    CitystringEmployer/Payer's city
Size Range: ..27
                    StatestringState 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"

                    ZipCdstringEmployer/Payer's zip code.
Size Range: 5..10
                ForeignAddressobjectif IsForeign is true, pass foreign address of the business
                    Address1stringEmployer/Payer's foreign address (street address or post office box of that locality)
Size Range: ..35
                    Address2stringOptional Employer/Payer's suite or apartment
Size Range: ..35
                    CitystringEmployer/Payer's city
Size Range: ..27
                    ProvinceOrStateNmstringEmployer/Payer's province or state name.
Size Range: ..30
                    CountrystringEmployer/Payer country code. Refer Static values.
Size Range: 2
Allowed values

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

                    PostalCdstringEmployer/Payer's postal code
            IsSeasonalEmployerBooleanWhen 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.
    ReturnDataobjectIdentifies the Form 941SCHR and Aggregate Form 941 data.
        Form941MainFilerDataobjectForm 941 details of the CPEO or the sec. 3504 Agent's employees for Schedule R.
            EmployeeCntnumberForm 941 details of the CPEO or the sec. 3504 Agent's employees for Schedule R.
Size Range: 7
            WagesAmtnumberGets the amount of wages, tips, and other compensation.
            FedIncomeTaxWHAmtnumberGets the amount of Federal income tax withheld from wages, tips, and other compensation.
            TotSSTax5a5bCol2numberSum of Total Social security tax of line 5a and line 5b in Column 2.
Size Range: 0-999999999999999.99
            TaxOnMedicareWagesTipsAmt_Col2numberTax withheld on medicare wages and tips of the main filer.
Size Range: 0-999999999999999.99
            TotSSMdcrTaxAmtnumberGets the amount of total social security and medicare taxes.
            TaxOnUnreportedTips3121qAmtnumberGets the amount of the Section 3121(q) Notice and Demand-Tax due on unreported tips.
Size Range: 0-999999999999999.99
            PayrollTaxCreditAmtnumberGets the amount of qualified small business payroll tax credit for increasing research.
            IsPayrollTaxCreditBooleanWhen 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.
            Form8974objectInformation of Form 8974
                Form8974IncomeTaxDetailsobject[]Collection of Income Tax details
                    IncomeTaxPeriodEndDatestringGets the ending date of income tax period in Part 1.
                    IncomeTaxReturnFiledFormstringGets 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.
                    IncomeTaxReturnFiledDatestringGets the income tax return filing date.
                    Form6765EINstringGets the EIN used on Form 6765 if the EIN used on Form 8974 doesn't match with the EIN on Form 6765.
                    Form6765Line44AmtnumberGets the amount from Form 6765, line 44 or the amount allocated to your EIN if applicable.
                    PreviousPeriodRemainingCreditAmtnumberGets the amount of credit taken on a previous period(s).
                    RemainingCreditnumberGets the total amount of remaining credit by subtracting
                Line7numberGets the total amount from Part 1, line 6(g). Part 2 Line 7.
Size Range: 0-9999999999999999999.99
                Line8numberGets 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
                Line9numberGets 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
                Line10numberGets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10.
Size Range: 0-9999999999999999999.99
                Line11numberGets 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
                PayerIndicatorTypestringIdentifies if you are a Third-party payer of sick pay or received a Section 3121(q) Notice and Demand
Allowed values

"THIRDPARTYSICKPAYIND", "SECTION3121QIND"

                Line12numberGets the credit amount smaller of line 7 or line 11.
Size Range: 0-9999999999999999999.99
                Line13numberSubtract Form 8974, line 12 from line 7. Enter the result on line 13
*Size Range: 0-*99999999999999.99
                Line14numberEnter the amount from Form 941, line 5c, column 2. This is the total amount of Medicare tax on wages.
*Size Range: 0-*99999999999999.99
                Line15numberEnter Form 8974, line 14 multiplied by 50% (0.50) on line 15.
*Size Range: 0-*99999999999999.99
                Line16numberEnter the smaller of line 13 or 15. This is the total credit against the employer share of Medicare tax.
*Size Range: 0-*99999999999999.99
                Line17numberAdd lines 12 and 16. Also, enter this amount on Form 941, line 11a;
*Size Range: 0-*99999999999999.99
            TotTaxAfterAdjustmentAndNonRfdCrnumberTotal taxes after adjustments and nonrefundable credits.
Size Range: 0-999999999999999.99
            TotTaxDepositAmtnumberGets the amount of total deposits.
        Form941ClientDetailsobject[]Collection of Form 941 details of each client for Schedule R
            CSeqIdstringA unique sequence number of a client
Size Range: ...10
            ClientNamestringClient's Name
Size Range: ...80
            ClientEINstringGets the client's Employer identification number (EIN).
Size Range: 9
            WagesTypeCdstringGets the code type of wages, tips, and other compensation (CPEO Use Only).
            EmployeeCntnumberThe total number of employees.
Size Range: 7
            WagesAmtnumberGets the amount of wages, tips, and other compensation.
Size Range: 0-9999999999999999999.99
            FedIncomeTaxWHAmtnumberGets the amount of federal income tax withheld from wages, tips, and other compensation.
Size Range: 0-9999999999999999999.99
            TotSSTax5a5bCol2numberSum of Total Social security tax of line 5a and line 5b in Column 2.
Size Range: 0-9999999999999999999.99
            TaxOnMedicareWagesTipsAmt_Col2numberTax withheld on medicare wages and tips of the main filer.
Size Range: 0-9999999999999999999.99
            TotSSMdcrTaxAmtnumberGets the amount of total social security and medicare taxes.
            TaxOnUnreportedTips3121qAmtnumberGets the amount of the Section 3121(q) Notice and Demand-Tax due on unreported tips.
Size Range: 0-999999999999999.99
            PayrollTaxCreditAmtnumberGets the amount of qualified small business payroll tax credit for increasing research.
            IsPayrollTaxCreditBooleanWhen 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.
            Form8974objectInformation of Form 8974
                Form8974IncomeTaxDetailsobject[]Collection of Income Tax details
                    IncomeTaxPeriodEndDatestringGets the ending date of income tax period in Part 1 Column (a).
                    IncomeTaxReturnFiledFormstringGets 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)
                    IncomeTaxReturnFiledDatestringGets the income tax return filing date shown in column (b). Part 1 Column (c)
                    Form6765EINstringGets 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)
                    Form6765Line44AmtnumberGets the amount from Form 6765, line 44 or the amount allocated to your EIN if applicable. Part 1 Column (e)
                    PreviousPeriodRemainingCreditAmtnumberGets the amount of credit from column (e) taken on a previous period(s). Part 1 Column (f)
                    RemainingCreditnumberGets the total amount of remaining credit by subtracting column (f) from column (e). Part 1 Column (g)
                Line7numberGets the total amount from Part 1, line 6(g). Part 2 Line 7.
Size Range: 0-9999999999999999999.99
                Line8numberGets 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
                Line9numberGets 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
                Line10numberGets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10.
Size Range: 0-9999999999999999999.99
                Line11numberGets 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
                PayerIndicatorTypestringIdentifies if you are a Third-party payer of sick pay or received a Section 3121(q) Notice and Demand
Allowed values

"THIRDPARTYSICKPAYIND", "SECTION3121QIND"

                Line12numberGets the credit amount smaller of line 7 or line 11.
Size Range: 0-9999999999999999999.99
                Line13numberSubtract Form 8974, line 12 from line 7. Enter the result on line 13
*Size Range: 0-*99999999999999.99
                Line14numberEnter the amount from Form 941, line 5c, column 2. This is the total amount of Medicare tax on wages.
*Size Range: 0-*99999999999999.99
                Line15numberEnter Form 8974, line 14 multiplied by 50% (0.50) on line 15.
*Size Range: 0-*99999999999999.99
                Line16numberEnter the smaller of line 13 or 15. This is the total credit against the employer share of Medicare tax.
*Size Range: 0-*99999999999999.99
                Line17numberAdd lines 12 and 16. Also, enter this amount on Form 941, line 11a;
*Size Range: 0-*99999999999999.99
            TotTaxAfterAdjustmentAndNonRfdCrnumberTotal taxes after adjustments and nonrefundable credits.
Size Range: 0-9999999999999999999.99
            TotTaxDepositAmtnumberGets the amount of total deposits.
            CRecordIdGuidClient Record Identifier.
        AggregateForm941DataobjectAggregate Form 941 (Totals of Clients + the main filer). For Form 941
            EmployeeCntnumberGets 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
            WagesAmtnumberGets the wages, tips, and other compensation for the Quarter
Size Range: 0-9999999999999999999.99
            FedIncomeTaxWHAmtnumberGets the federal income tax withheld from wages, tips, and other compensation
Size Range: 0-9999999999999999999.99
            WagesNotSubjToSSMedcrTaxIndBooleanWhen true, identifies if no wages, tips, and other compensation on line 2 are subject to social security or Medicare tax.
            SocialSecurityTaxCashWagesAmt_Col1numberGets the taxable social security wages amount. Line 5a Column 1
Size Range: 0-9999999999999999999.99
            TaxableSocSecTipsAmt_Col1numberGets the taxable social security tips amount. Line 5b Column 1
Size Range: 0-9999999999999999999.99
            TaxableMedicareWagesTipsAmt_Col1numberGets the taxable medicare wages and tips amount. Line 5c Column 1.
Size Range: 0-9999999999999999999.99
            TxblWageTipsSubjAddnlMedcrAmt_Col1numberGets the taxable wages and tips subject to additional Medicare Tax withholding amount. Line 5d Column 1
Size Range: 0-9999999999999999999.99
            SocialSecurityTaxAmt_Col2numberGets the tax on Social Security Wages. Line 5a Column 2
Size Range: 0-9999999999999999999.99
            TaxOnSocialSecurityTipsAmt_Col2numberGets the tax on Social Security Tips. Line 5b Column 2
Size Range: 0-9999999999999999999.99
            TaxOnMedicareWagesTipsAmt_Col2numberGets the tax on Taxable Medicare Wages and Tips subject to Medicare Amount. Line 5c Column 2
Size Range: 0-9999999999999999999.99
            TaxOnWageTipsSubjAddnlMedcrAmt_Col2numberGets the tax on Taxable Wages and Tips subject to Additional Medicare Tax withholding amount. Line 5d Column 2
Size Range: 0-9999999999999999999.99
            TotSSMdcrTaxAmtnumberGets the Total Social Security and Medicare Tax Amount. Line 5e
Size Range: 0-9999999999999999999.99
            TaxOnUnreportedTips3121qAmtnumberGets the tax due from Section 3121(q) Notice and Demand on line 5f
Size Range: 0-9999999999999999999.99
            TotalTaxBeforeAdjustmentAmtnumberGets the Total taxes before adjustments by adding the amounts on lines 3, 5e, and 5f on Line 6.
Size Range: 0-999999999999999.99
            CurrentQtrFractionsCentsAmtnumberGets the amount of current quarter's adjustment for fractions of cents. Line 7.
Size Range: 0-999999999999999.99
            CurrentQuarterSickPaymentAmtnumberGets the amount of current quarter's adjustment for sick pay. Line 8.
Size Range: 0-999999999999999.99
            CurrQtrTipGrpTermLifeInsAdjAmtnumberGets the amount of current quarter's adjustments for tips and group-term life insurance. Line 9.
Size Range: 0-999999999999999.99
            TotalTaxAfterAdjustmentAmtnumberGets the amount of Total taxes after adjustments by adding amount in line 6 through line 9. Line 10.
Size Range: 0-999999999999999.99
            PayrollTaxCreditAmtnumberGets the amount of qualified small business payroll tax credit for increasing research activities. Line 11.
Size Range: 0-9999999999999999999.99
            IsPayrollTaxCreditBooleanWhen 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.
            FilerTypestringGets the Type of the filer.
Allowed values

"Section 3504 Agent", "CPEO", "Other Third Party Paid Preparer"

            TotTaxAfterAdjustmentAndNonRfdCrnumberTotal taxes after adjustments and nonrefundable credits.
Size Range: 0-9999999999999999999.99
            TotTaxDepositAmtnumberGets 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
            BalanceDueAmtnumberGets the difference amount of the balance due if line 12 is more than line 13. Line 14
Size Range: 0-9999999999999999999.99
            OverpaidAmtnumberGets the difference overpayment amount if line 13 is more than line 12. Line 15.
Size Range: 0-9999999999999999999.99
            OverPaymentRecoveryTypestringGets 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.
        IRSPaymentTypestringEFW or EFTPS or Check / Money Order
        IRSPaymentobjectIdentifies the details of Electronic Funds Withdrawal (EFW) if paying the balance due along with the return
            BankRoutingNumstringBank Routing Number of EFW payment
            AccountTypestringAccount Type of EFW payment
Allowed values

"CHECKING", "SAVING"

            BankAccountNumstringBank Account Number of EFW payment
Size Range: 0...17
            PhonestringPhone of EFW payment
Size Range: 10
        DepositScheduleTypeobjectIdentifies the Employer's deposit schedule and tax liability for the quarter
            DepositorTypestringType of Deposit Schedule. Values like Minimum Tax Liability, Monthly or Semi Weekly
            MonthlyDepositorobjectLine 16, Option 2. Monthly Schedule Depositor
                TaxLiabilityMonth1numberTax Liability for Month 1 of the filing quarter
                TaxLiabilityMonth2numberTax Liability for Month 2 of the filing quarter
                TaxLiabilityMonth3numberTax Liability for Month 3 of the filing quarter
            SemiWeeklyDepositorobjectLine 16, Option 3. SemiWeekly Depositor
                ScheduleBMonth1Amtobject[]Tax Liability for Month 1 of the filing quarter in Form Schedule B
                    DaystringTax 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"

                    AmtnumberTax Liability Amount
Size Range: 0-99999999999999.99
                ScheduleBMonth2Amtobject[]Tax Liability for Month 2 of the filing quarter in Form Schedule B
                    DaystringTax 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"

                    AmtnumberTax Liability Amount
Size Range: 0-99999999999999.99
                ScheduleBMonth3Amtobject[]Tax Liability for Month 3 of the filing quarter in Form Schedule B
                    DaystringTax 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"

                    AmtnumberTax Liability Amount
Size Range: 0-99999999999999.99
            TotalQuarterTaxLiabilityAmtnumberTotal 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": "Q1",
"Business": {
"BusinessId": null,
"BusinessNm": "ABC 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": "ABC 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

FieldTypeDescription
StatusCodenumberReturns the HTTP status codes like 200,300 etc.
StatusNamestringName of the status code.
StatusMessagestringDetailed status message.
    ErrorRecordsobject[]It will show the detailed information about the error status of Form 941 Schedule R Records
    SequenceIdstringA unique number given by an inbound application to identify failed records.
    RecordIdGuidUnique identifier of a record
    Errorsobject[]Shows detailed error information.
        IdstringReturns the validation error id.
        NamestringName of the validation error.
        MessagestringDescription of the validation error.
Errorsobject[]Shows detailed error information.
    IdstringReturns the validation error id.
    NamestringName of the validation error.
    MessagestringDescription of the validation error.

Response JSON

{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"ErrorRecords" : null,
"Errors": null
}