Version: 1.7.1

ValidateForm

Runs business and data validation checks for 943 forms.

POST Form943/ValidateForm

Request Body

Field	Type	Description
Form943Records	object[]	Object to create 943s
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 943.
ReturnType	string	Type of the return to be filed. Enter values like FORM943, FORM943PR Allowed values: "FORM943", "FORM943PR"
TaxYr	string	The Tax year for which Form 943 needs to be filed. Allowed values: "2022"
Business	object	Business Details
BusinessId	Guid	Optional Use 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	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 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. 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: ..35
Address2	string	Optional Employer/Payer's suite or apartment Size Range: ..35
City	string	Employer/Payer's city Size Range: ..27
State	string	Employer/Payer's state 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: ..35
Address2	string	Optional Employer/Payer's suite or apartment Size Range: ..35
City	string	Employer/Payer's city Size Range: ..27
ProvinceOrStateNm	string	Employer/Payer's province or state name Size Range: ..30
Country	string	Employer/Payer's country 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"
PostalCd	string	Employer/Payer's postal code
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 943
SignatureType	string	Type of signature used to sign Form 943 Allowed values "REPORTING_AGENT", "ONLINE_SIGN_PIN", "FORM_8453_EMP", "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
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: ..35
Address2	string	Optional Employer/Payer's suite or apartment Size Range: ..35
City	string	Employer/Payer's city Size Range: ..27
State	string	Employer/Payer's state 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: ..35
Address2	string	Optional Employer/Payer's suite or apartment Size Range: ..35
City	string	Employer/Payer's city Size Range: ..27
ProvinceOrStateNm	string	Employer/Payer's province or state name Size Range: ..30
Country	string	Employer/Payer's country 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"
PostalCd	string	Employer/Payer's postal code
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: ..35
Address2	string	Optional Employer/Payer's suite or apartment Size Range: ..35
City	string	Employer/Payer's city Size Range: ..27
State	string	State code of the employer/payer. Refer Static values. 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: ..35
Address2	string	Optional Employer/Payer's suite or apartment Size Range: ..35
City	string	Employer/Payer's city Size Range: ..27
ProvinceOrStateNm	string	Employer/Payer's province or state name. Size Range: ..30
Country	string	Employer/Payer country code. Refer Static values. 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"
PostalCd	string	Employer/Payer's postal code
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 943 data
Form943	object	Form 943, Employer's QUARTERLY Federal Tax Return
IsAddDiffFromPriorYear	Boolean	When true, identifies that the business address is different from prior year.
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).
SocialSecurityTaxCashWagesAmt	number	Gets the taxable social security wages amount. Size Range: 0-99999999999999.99
QualSickLeaveWagesAmt	number	Qualified Sick Leave wages under SS wage base column 1. Size Range: 0-99999999999999.99
QualFamilyLeaveWagesAmt	number	Qualified Family Leave wages under SS wage base column 1. Size Range: 0-99999999999999.99
SocialSecurityTaxAmt	number	Gets the tax on Social Security Wages. Size Range: 0-99999999999999.99
TaxOnQualSickLeaveWagesAmt	number	Qualified Sick Leave wages under SS wage base. Size Range: 0-99999999999999.99
TaxOnQualFamilyLeaveWagesAmt	number	Qualified Family Leave wages under SS wage base. Size Range: 0-99999999999999.99
MedicareTaxCashWagesAmt	number	Gets the taxable Medicare wages amount. Size Range: 0-99999999999999.99
TaxOnMedicareWagesAmt	number	Tax on Medicare wages Size Range: 0-99999999999999.99
AddnlMedicareTaxCashWagesAmt	number	Gets the tax on Taxable Wages and Tips subject to Additional Medicare Tax withholding amount. Size Range: 0-99999999999999.99
TaxOnAddnlMedicareTaxWagesAmt	number	Gets the tax on Taxable Wages and Tips subject to Additional Medicare Tax withholding amount. Size Range: 0-99999999999999.99
FedIncomeTaxWHAmt	number	Enter the Federal Tax amount Withheld for Form 943.
TotalTaxBeforeAdjustmentAmt	number	Gets the Total taxes before adjustments by adding the amounts on lines 3, 3a, 3b, 5, 7 & 8. Size Range: 0-99999999999999.99
CurrentYearAdjustmentAmt	number	Gets the amount of current year adjustment. Size Range: -99999999999999.99 to 99999999999999.99
TotalTaxAfterAdjustmentAmt	number	Gets the amount of Total taxes after adjustments by adding amount in line 9 & line 10. Line 11. Size Range: 0-99999999999999.99
PayrollTaxCreditAmt	number	Gets the amount of qualified small business payroll tax credit for increasing research activities. Line 11. Size Range: 0-99999999999999.99
IsPayrollTaxCredit	Boolean	When true, identifies the Line 11 is greater than zero to determine the amount of qualified small business payroll tax credit for increasing research activities that a business can claim on Form 943.
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, Form 1065, Form 1120, Form 1120_F, or Form 1120S. Part 1 Column (b) Allowed values “Form1040”, “Form1065”, “Form1120”, “Form1120_F”
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	number	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	number	Gets the amount of credit from column (e) taken on a previous period(s). Part 1 Column (f) Size Range: 0-99999999999999.99
RemainingCredit	number	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.Not applicable to Form 943/943-PR.
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	number	Gets the credit amount smaller of line 7 or line 11. Also, this amount entered on Form 941 (941-PR or 941-SS), line 11; Form 943 (943-PR), line 12; or Form 944 (944(SP)), line 8 Size Range: 0-99999999999999.99
NonRfdCrQualSickAndFamily WagesB4_Apr1_2021	number	Nonrefundable portion of credit for qualified sick and family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99
NonRfdCrQualSickAndFamily WagesAfter_Mar31_2021And B4_Oct1_2021	number	Nonrefundable portion of credit for qualified sick and family leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99
NonRfdCobraPremAsstCr	number	Nonrefundable portion of COBRA premium assistance credit. Not applicable from Q2 2022. Size Range: 0-99999999999999.99
NumOfIndivCobraPremAsst	int	Number of individuals provided with COBRA premium assistance.Not applicable from Q2 2022.
TotlNonRfdCrAmt	number	Total nonrefundable credits Size Range: 0-99999999999999.99
TotTaxAfterAdjustmentAndNonRfdCr	number	Total taxes after adjustments and nonrefundable credits. Size Range: 0-99999999999999.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-99999999999999.99
RfdCrQualSickAndFamilyWages B4_Apr1_2021	number	Refundable portion of credit for qualified sick and family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99
RfdCrQualSickAndFamily WagesAfter_Mar31_2021And B4_Oct1_2021	number	Refundable portion of credit for qualified sick and family leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99
RfdCobraPremAsstCr	number	Refundable portion of COBRA premium assistance credit.Not applicable from Q2 2022. Size Range: 0-99999999999999.99
TotDepositAndRfdCrAmt	number	Total deposits and refundable credits. Size Range: 0-99999999999999.99
BalanceDueAmt	number	Gets the difference amount of the balance due if line 12 is more than line 13. Line 14. Size Range: 0-99999999999999.99
OverpaidAmt	number	Gets the difference overpayment amount if line 13 is more than line 12. Line 15. Size Range: 0-99999999999999.99
OverPaymentRecoveryType	string	Gets the overpayment recovery type, whether to have the IRS refund the excess amount or apply it to next return. Check only one box on line 15. Allowed values "REFUND", "APPLYTORETURN"
QualHealthPlanExpToSickLeave WagesB4_Apr1_2021	number	Qualified health plan expenses allocable to qualified sick leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99
QualHealthPlanExpToFamilyLeave WagesB4_Apr1_2021	number	Qualified health plan expenses allocable to qualified family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99
QualSickLeaveWages After_Mar31_2021And B4_Oct1_2021	number	Qualified sick leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99
QualHealthPlanExpToSickLeave WagesAfter_Mar31_2021And B4_Oct1_2021	number	Qualified health plan expenses allocable to qualified sick leave wages reported on line 23. Size Range: 0-99999999999999.99
CBAToSickLeaveWages After_Mar31_2021And B4_Oct1_2021	number	Amounts under certain collectively bargained agreements allocable to qualified sick leave wages reported on line 23. Size Range: 0-99999999999999.99
QualFamilyLeaveWages After_Mar31_2021And B4_Oct1_2021	number	Qualified family leave wages for leave taken after March 31, 2021 and before October 1, 2021. Size Range: 0-99999999999999.99
QualHealthPlanExpToFamilyLeave WagesAfter_Mar31_2021And B4_Oct1_2021	number	Qualified health plan expenses allocable to qualified family leave wages reported on line 26. Size Range: 0-99999999999999.99
CBAToFamilyLeaveWages After_Mar31_2021And B4_Oct1_2021	number	Amounts under certain collectively bargained agreements allocable to qualified family leave wages reported on line 26. Size Range: 0-99999999999999.99
IRSPaymentType	string	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
DepositScheduleType	object	Identifies the Employer's deposit schedule and tax liability for the quarter
DepositorType	string	Type of Deposit Schedule. Values like Monthly or Semi Weekly Allowed values "MINTAXLIABILITY", "MONTHLY", "SEMIWEEKLY"
MonthlyDepositor	object	Line 17 Monthly Schedule Depositor details.
JanTaxLiability	number	Tax Liability for January.
FebTaxLiability	number	Tax Liability for Febraury.
MarTaxLiability	number	Tax Liability for March.
AprTaxLiability	number	Tax Liability for April.
MayTaxLiability	number	Tax Liability for May.
JunTaxLiability	number	Tax Liability for June.
JulTaxLiability	number	Tax Liability for July.
AugTaxLiability	number	Tax Liability for August.
SepTaxLiability	number	Tax Liability for September.
OctTaxLiability	number	Tax Liability for October.
NovTaxLiability	number	Tax Liability for November.
DecTaxLiability	number	Tax Liability for December.
SemiWeeklyDepositor	object	SemiWeekly Depositor details.
Form943AJanMonthAmt	object[]	Tax Liability for January in Form 943 A.
Day	string	Tax Liability Day of Jan month. Allowed values "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"
Amt	number	Tax Liability Amount of Jan month. Size Range: 0-99999999999999.99
Form943AJanMonthTotAmt	number	Total Tax Liability for January in Form 943 A. Size Range: 0-99999999999999.99
Form943AFebMonthAmt	object[]	Tax Liability for February in Form 943 A.
Day	string	Tax Liability Day of Feb month. Allowed values "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"
Amt	number	Tax Liability Amount of Feb month. Size Range: 0-99999999999999.99
Form943AFebMonthTotAmt	number	Total Tax Liability for February in Form 943 A. Size Range: 0-99999999999999.99
Form943AMarMonthAmt	object[]	Tax Liability for March in Form 943 A.
Day	string	Tax Liability Day of Mar month. Allowed values "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"
Amt	number	Tax Liability Amount of Mar month. Size Range: 0-99999999999999.99
Form943AJMarMonthTotAmt	number	Total Tax Liability for March in Form 943 A. Size Range: 0-99999999999999.99
Form943AAprMonthAmt	object[]	Tax Liability for April in Form 943 A.
Day	string	Tax Liability Day of Apr month. Allowed values "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"
Amt	number	Tax Liability Amount of Apr month. Size Range: 0-99999999999999.99
Form943AAprMonthTotAmt	number	Total Tax Liability for April in Form 943 A. Size Range: 0-99999999999999.99
Form943AMayMonthAmt	object[]	Tax Liability for May in Form 943 A.
Day	string	Tax Liability Day of May month. Allowed values "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"
Amt	number	Tax Liability Amount of May month. Size Range: 0-99999999999999.99
Form943AMayMonthTotAmt	number	Total Tax Liability for May in Form 943 A. Size Range: 0-99999999999999.99
Form943AJunMonthAmt	object[]	Tax Liability for June in Form 943 A.
Day	string	Tax Liability Day of Jun month. Allowed values "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"
Amt	number	Tax Liability Amount of Jun month. Size Range: 0-99999999999999.99
Form943AJunMonthTotAmt	number	Total Tax Liability for June in Form 943 A. Size Range: 0-99999999999999.99
Form943AJulMonthAmt	object[]	Tax Liability for July in Form 943 A.
Day	string	Tax Liability Day of Jul month. Allowed values "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"
Amt	number	Tax Liability Amount of Jul month. Size Range: 0-99999999999999.99
Form943AJulMonthTotAmt	number	Total Tax Liability for July in Form 943 A. Size Range: 0-99999999999999.99
Form943AAugMonthAmt	object[]	Tax Liability for August in Form 943 A.
Day	string	Tax Liability Day of Aug month. Allowed values "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"
Amt	number	Tax Liability Amount of Aug month. Size Range: 0-99999999999999.99
Form943AAugMonthTotAmt	number	Total Tax Liability for August in Form 943 A. Size Range: 0-99999999999999.99
Form943ASepMonthAmt	object[]	Tax Liability for September in Form 943 A.
Day	string	Tax Liability Day of Sep month. Allowed values "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"
Amt	number	Tax Liability Day of Sep month. Size Range: 0-99999999999999.99
Form943ASepMonthTotAmt	number	Total Tax Liability for September in Form 943 A. Size Range: 0-99999999999999.99
Form943AOctMonthAmt	object[]	Tax Liability for October in Form 943 A.
Day	string	Tax Liability Day of Oct month. Allowed values "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"
Amt	number	Tax Liability Amount of Oct month. Size Range: 0-99999999999999.99
Form943AOctMonthTotAmt	number	Total Tax Liability for October in Form 943 A. Size Range: 0-99999999999999.99
Form943ANovMonthAmt	object[]	Tax Liability for November in Form 943 A.
Day	string	Tax Liability Day of Nov month. Allowed values "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"
Amt	number	Tax Liability Amount of Nov month. Size Range: 0-99999999999999.99
Form943ANovMonthTotAmt	number	Total Tax Liability for November in Form 943 A. Size Range: 0-99999999999999.99
Form943ADecMonthAmt	object[]	Tax Liability for December in Form 943 A.
Day	string	Tax Liability Day of Dec month. Allowed values "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"
Amt	number	Tax Liability Amount of Dec month. Size Range: 0-99999999999999.99
Form943ADecMonthTotAmt	number	Total Tax Liability for December in Form 943 A. Size Range: 0-99999999999999.99
TotalTaxLiabilityWholeYearAmt	number	Total tax liability amount Size Range: 0-99999999999999.99

Request JSON

{
    "Form943Records": [
        {
            "SequenceId": "2790608985",
            "ReturnHeader": {
                "ReturnType": "FORM943",
                "TaxYr": "2022",
                "Business": {
                    "BusinessId": null,
                    "BusinessNm": "Snowdaze LLC",
                    "TradeNm": "Kodak Company",
                    "IsEIN": true,
                    "EINorSSN": "144718269",
                    "Email": "sample@bodeem.com",
                    "ContactNm": "John Parker",
                    "Phone": "9184567890",
                    "PhoneExtn": "32324",
                    "Fax": "3456734567",
                    "BusinessType": "PART",
                    "SigningAuthority": {
                        "Name": "Peter Parker",
                        "Phone": "4651337891",
                        "BusinessMemberType": "MEMBER"
                    },
                    "KindOfEmployer": "STATEORLOCAL501C",
                    "KindOfPayer": "HOUSEHOLD",
                    "IsBusinessTerminated": false,
                    "IsForeign": false,
                    "USAddress": {
                        "Address1": "1751 Kinsey Rd",
                        "Address2": "Main St",
                        "City": "Dothan",
                        "State": "AL",
                        "ZipCd": "36303"
                    },
                    "ForeignAddress": {
                        "Address1": "45 Main St",
                        "Address2": "Crescent Ave",
                        "City": "Toronto",
                        "ProvinceOrStateNm": "ON",
                        "Country": "CA",
                        "PostalCd": "4T3 B5F"
                    }
                },
                "IsThirdPartyDesignee": false,
                "ThirdPartyDesignee": {
                    "Name": null,
                    "Phone": null,
                    "PIN": null
                },
                "SignatureDetails": {
                    "SignatureType": "ONLINE_SIGN_PIN",
                    "OnlineSignaturePIN": {
                        "PIN": "1445174532"
                    },
                    "ReportingAgentPIN": {
                        "PIN": null
                    },
                    "Form8453EMP": null
                },
                "BusinessStatusDetails": {
                    "IsBusinessClosed": false,
                    "BusinessClosedDetails": {
                        "Name": null,
                        "FinalDateWagesPaid": null,
                        "IsForeign": false,
                        "USAddress": {
                            "Address1": null,
                            "Address2": null,
                            "City": null,
                            "State": null,
                            "ZipCd": null
                        },
                        "ForeignAddress": {
                            "Address1": null,
                            "Address2": null,
                            "City": null,
                            "ProvinceOrStateNm": null,
                            "Country": null,
                            "PostalCd": null
                        }
                    },
                    "IsBusinessTransferred": false,
                    "BusinessTransferredDetails": {
                        "Name": null,
                        "BusinessChangeType": null,
                        "DateOfChange": null,
                        "NewBusinessType": null,
                        "NewBusinessName": null,
                        "IsForeign": false,
                        "USAddress": {
                            "Address1": null,
                            "Address2": null,
                            "City": null,
                            "State": null,
                            "ZipCd": null
                        },
                        "ForeignAddress": {
                            "Address1": null,
                            "Address2": null,
                            "City": null,
                            "ProvinceOrStateNm": null,
                            "Country": null,
                            "PostalCd": null
                        }
                    }
                }
            },
            "ReturnData": {
                "Form943": {
                    "IsAddDiffFromPriorYear": false,
                    "EmployeeCnt": 250,
                    "SocialSecurityTaxCashWagesAmt": 5992289.00,
                    "QualSickLeaveWagesAmt": 10000.00,
                    "QualFamilyLeaveWagesAmt": 25000.00,
                    "SocialSecurityTaxAmt": 743043.84,
                    "TaxOnQualSickLeaveWagesAmt": 620.00,
                    "TaxOnQualFamilyLeaveWagesAmt": 1550.00,
                    "MedicareTaxCashWagesAmt": 15000.00,
                    "TaxOnMedicareWagesAmt": 435.00,
                    "AddnlMedicareTaxCashWagesAmt": 5000.00,
                    "TaxOnAddnlMedicareTaxWagesAmt": 45.00,
                    "FedIncomeTaxWHAmt": 45000.00,
                    "TotalTaxBeforeAdjustmentAmt": 790693.84,
                    "CurrentYearAdjustmentAmt": -24758.00,
                    "TotalTaxAfterAdjustmentAmt": 765935.84,
                    "PayrollTaxCreditAmt": 10000.00,
                    "Form8974": {
                        "Form8974IncomeTaxDetails": [
                            {
                                "IncomeTaxPeriodEndDate": "04/17/2022",
                                "IncomeTaxReturnFiledForm": "FORM1065",
                                "IncomeTaxReturnFiledDate": "07/02/2022",
                                "Form6765EIN": "001283308",
                                "Form6765Line44Amt": 5000,
                                "PreviousPeriodRemainingCreditAmt": 2000,
                                "RemainingCredit": 3000
                            },
                            {
                                "IncomeTaxPeriodEndDate": "10/21/2022",
                                "IncomeTaxReturnFiledForm": "FORM1040",
                                "IncomeTaxReturnFiledDate": "05/02/2022",
                                "Form6765EIN": "001287038",
                                "Form6765Line44Amt": 5000.00,
                                "PreviousPeriodRemainingCreditAmt": 3000,
                                "RemainingCredit": 2000.00
                            },
                            {
                                "IncomeTaxPeriodEndDate": "07/07/2022",
                                "IncomeTaxReturnFiledForm": "FORM1120",
                                "IncomeTaxReturnFiledDate": "11/07/2022",
                                "Form6765EIN": "001287298",
                                "Form6765Line44Amt": 2000,
                                "PreviousPeriodRemainingCreditAmt": 1000.00,
                                "RemainingCredit": 1000.00
                            },
                            {
                                "IncomeTaxPeriodEndDate": "07/07/2022",
                                "IncomeTaxReturnFiledForm": "FORM1120_F",
                                "IncomeTaxReturnFiledDate": "07/07/2022",
                                "Form6765EIN": "001241038",
                                "Form6765Line44Amt": 6000,
                                "PreviousPeriodRemainingCreditAmt": 4000.00,
                                "RemainingCredit": 2000
                            },
                            {
                                "IncomeTaxPeriodEndDate": "07/07/2022",
                                "IncomeTaxReturnFiledForm": "FORM1120S",
                                "IncomeTaxReturnFiledDate": "07/12/2022",
                                "Form6765EIN": "001444047",
                                "Form6765Line44Amt": 10000,
                                "PreviousPeriodRemainingCreditAmt": 8000,
                                "RemainingCredit": 2000.00
                            }
                        ],
                        "Line7": 10000,
                        "Line8": 743043.84,
                        "Line9": 0,
                        "Line10": 743043.84,
                        "Line11": 371521.92,
                        "PayerIndicatorType": "THIRDPARTYSICKPAYIND",
                        "Line12": 10000
                    },
                    "NonRfdCrQualSickAndFamilyWagesB4_Apr1_2021": 13000.00,
                    "NonRfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021": 17000.00,
                    "NonRfdCobraPremAsstCr": 13000.00,
                    "NumOfIndivCobraPremAsst": 90,
                    "TotlNonRfdCrAmt": 53000.00,
                    "TotTaxAfterAdjustmentAndNonRfdCr": 712935.84,
                    "TotTaxDepositAmt": 25000.00,
                    "RfdCrQualSickAndFamilyWagesB4_Apr1_2021": 12000.00,
                    "RfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021": 7000.00,
                    "RfdCobraPremAsstCr": 0,
                    "TotDepositAndRfdCrAmt": 44000.00,
                    "BalanceDueAmt": 668935.84,
                    "OverpaidAmt": 0,
                    "OverPaymentRecoveryType": null,
                    "QualHealthPlanExpToSickLeaveWagesB4_Apr1_2021": 0,
                    "QualHealthPlanExpToFamilyLeaveWagesB4_Apr1_2021": 0,
                    "QualHealthPlanExpToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 22000.00,
                    "CBAToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": "5000.00",
                    "QualFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": "7000.00",
                    "QualHealthPlanExpToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": "3500.00",
                    "CBAToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 2000
                },
                "IRSPaymentType": "EFTPS",
                "IRSPayment": {
                    "BankRoutingNum": null,
                    "AccountType": null,
                    "BankAccountNum": null,
                    "Phone": null
                },
                "DepositScheduleType": {
                    "DepositorType": "MONTHLY",
                    "MonthlyDepositor": {
                        "JanTaxLiability": "12000.00",
                        "FebTaxLiability": 0,
                        "MarTaxLiability": 0,
                        "AprTaxLiability": "51728.00",
                        "MayTaxLiability": "257992.00",
                        "JunTaxLiability": 0,
                        "JulTaxLiability": 0,
                        "AugTaxLiability": "250000.00",
                        "SepTaxLiability": 0,
                        "OctTaxLiability": "100078.84",
                        "NovTaxLiability": "40000.00",
                        "DecTaxLiability": "1137.00"
                    },
                    "SemiWeeklyDepositor": null,
                    "TotalTaxLiabilityWholeYearAmt": 712935.84
                }
            }
        }
    ]
}

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.
Errors	object[]	Shows detailed error information.
Code	string	Returns the validation error code.
Name	string	Name of the validation error.
Message	string	Description of the validation error.
Type	string	Type of validation error.

Response JSON

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

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

W-9 Automation

BOI Automation New

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

Request Body

Request JSON

Response Body

Response JSON