# Form943

# Create

Creates Form 943 returns with a unique Submission Id which is further used for all other methods referencing these 943s.

POST Form943/Create

Request Parameters

Field	Type	Description
Form943Records	object[]	Object to create 943s
Sequence	string	A unique number given by an inbound application to identify 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. Allowed values: "FORM943"
TaxYr	string	The Tax year for which, Form 943 needs to be filed. Allowed values: "2019"
Business	object	Business Details
BusinessId	guid	Business Identifier (Autogenerated).
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
Email	string	Email address of the Business Size Range: ..40
ContactNm	string	Name of the person who can be contacted by the IRS Size Range: ..27
Phone	string	Contact number of the business with area code Size Range: 10
PhoneExtn	string	`Optional` Extension of the business phone number Size Range: ..5
Fax	string	`Optional` Fax number of the Business Size Range: 10
BusinessType	string	Type of business. Optional for W-2/1099 and mandatory for 94X series Size Range: ..4 Allowed values: "ESTE", "PART", "CORP", "EORG", "SPRO"
SigningAuthority	object	Details of the person who is authorized to sign the return
Name	string	Name of the signing authority. Size Range: ..35
Phone	string	Phone number of the signing authority. Size Range: 10
BusinessMemberType	string	Business title of the signing authority Size Range: 5..29 Allowed values: "CORPORATESECRETARY", "SECRETARYTREASURER", "PARTNER", "GENERALPARTNER", "LIMITEDPARTNER", "LLCMEMBER", "MANAGINGMEMBER", "MANAGER", "TAXMATTERPARTNER", "PRESIDENT", "VICEPRESIDENT", "CORPORATETREASURER", "TREASURER", "ASSISTANTTREASURER", "CHIEFACCOUNTINGOFFICER", "CHIEFEXECUTIVEOFFICER", "CHIEFFINANCIALOFFICER", "TAXOFFICER", "CHIEFOPERATINGOFFICER", "CORPORATEOFFICER", "EXECUTIVEDIRECTOR", "DIRECTOR", "CHAIRMAN", "EXECUTIVEADMINISTRATOR", "RECEIVER", "PASTOR", "ASSISTANTTORELIGIOUSLEADER", "REVEREND", "PRIEST", "MINISTER", "RABBI", "LEADEROFRELIGIOUSORGANIZATION", "SECRETARY", "DIRECTOROFTAXATION", "DIRECTOROFPERSONNEL", "ADMINISTRATOR", "EXECUTOR", "TRUSTEE", "FIDUCIARY", "OWNER", "SOLEPROPRIETOR", "MEMBER", "SOLEMEMBER"
KindOfEmployer	string	Identifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series. Allowed values: "FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"
KindOfPayer	string	Kind Of Payer based on the Employer's Federal Tax Return. Allowed values: "REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"
IsBusinessTerminated	Boolean	When true, identifies the business as terminated.
IsForeign	Boolean	When true, identifies the business address with a foreign address.
USAddress	object	if IsForeign is false, pass US address of the business
Address1	string	Employer/Payer's US address (street address or post office box of that locality) Size Range: ..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 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
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 Size Range: 2 Allowed values: "US", "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"
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
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 Buiness 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 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
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 Size Range: 2 Allowed values: "US", "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	Not Required
BusinessTransferredDetails	object	Not Required
IsSeasonalEmployer	Boolean	Not Required
ReturnData	object	Identifies the Form 943 data
Form943	object	Form 943, Employer’s Annual Federal Tax Return for Agricultural Employees
PriorAddressInd	Boolean	When true, identifies if address is different from prior return.
EmployeeCnt	number	Gets the number of Employees who has received wages, tips, or other compensation for the pay period. Line 1 Size Range: 7
SocialSecurityTaxCashWagesAmt	number	Gets the taxable social security wages amount. Line 2 Size Range: 0-99999999999999.99
SocialSecurityTaxAmt	number	Gets the social security tax amount. Line 3 Size Range: 0-99999999999999.99
MedicareTaxCashWagesAmt	number	Gets the total medicare wages amount. Line 4 Size Range: 0-99999999999999.99
MedicareTaxWithheldAmt	number	Gets the taxable medicare withheld amount. Line 5 Size Range: 0-99999999999999.99
TotMedcrTaxCashWagesAddnlWhAmt	number	Gets the taxable wages subject to additional Medicare Tax withholding amount. Line 6 Size Range: 0-99999999999999.99
AddnlMedicareTaxWithholdingAmt	number	Gets additional Medicare Tax withholding amount. Line 7 Size Range: 0-99999999999999.99
FederalIncomeTaxWithheldAmt	number	Gets the Federal Income Tax withheld amount. Line 8 Size Range: 0-99999999999999.99
TotalTaxBeforeAdjustmentAmt	number	Gets the total taxes before adjustments Line 9 by adding lines 3, 5,7 and 8. Size Range: 0-99999999999999.99
CurrentYearAdjustmentAmt	number	Gets the current year's adjustments. Line 10 Size Range: -99999999999999.99-99999999999999.99
TotalTaxAfterAdjustmentAmt	number	Gets the Total taxes after adjustments Line 11 (line 9 as adjusted by line 10). Size Range: 0-99999999999999.99
PayrollTaxCreditAmt	number	Gets the qualified small business payroll tax credit. Line 12 Size Range: 0-99999999999999.99
Form8974	object	Information of Form 8974
Form8974IncomeTaxDetails	object[]	Collection of Income Tax details
IncomeTaxPeriodEndDate	string	Gets the ending date of income tax period in Part 1 Column (a).
IncomeTaxReturnFiledForm	string	Gets the Income tax return filed to elected a qualified small business payroll tax credit on Form 6765. Form 6765 can be attached to Form 1040, 1065, 1120, 1120-F, or 1120S. Part 1 Column (b)
IncomeTaxReturnFiledDate	string	Gets the income tax return filing date shown in column (b). Part 1 Column (c)
Form6765EIN	string	Gets the EIN used on Form 6765 if the EIN used on Form 8974 doesn't match with the EIN on Form 6765. Part 1 Column (d) Size Range: 9
Form6765Line44Amt	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. 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. 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. Size Range: 0-99999999999999.99
Line10	number	Gets the total amount by adding the amounts of lines 8 and 9. 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 943 (943-PR or 943-SS), line 11; Form 943 (943-PR), line 12; or Form 944 (944(SP)), line 8 Size Range: 0-99999999999999.99
TotalTaxAmt	number	Gets the Total taxes after adjustments and credits Line 13 (by subtracting line 12 from line 11). Size Range: 0-99999999999999.99
TotalTaxDepositAmt	number	Gets the amount of total tax deposits including overpayment applied from prior year and Form 943-x. Line 14. Size Range: 0-99999999999999.99
BalanceDueAmt	number	Gets the amount of Balance Due Line 15 (difference between line 13 and line 14, if line 13 is greater than line 14). Size Range: 0-99999999999999.99
OverpaidAmt	number	Gets the amount Overpayment amount Line 16 (difference between line 14 and line 13, if line 14 is greater than line 13). 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. Allowed values: "REFUND", "APPLYTORETURN"
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 (Checking or Saving) of EFW payment
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 Jume 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

Response Parameters

Field	Type	Description
StatusCode	number	Returns the HTTP status codes like 200,300 etc.
StatusName	string	Name of the status code.
StatusMessage	string	Detailed status message.
SubmissionId	Guid	Unique identifier of a submission.
Form943Records	object	Pulls the Form 943 records with Success and Error statuses.
SuccessRecords	object[]	It will show the detailed information about the success status of Form 943 Records.
Sequence	string	A unique number given by an inbound application to identify failed records.
RecordId	Guid	Unique identifier of a record.
RecordStatus	string	Returns the status of the records.
CreatedTs	string	Date and time of return created.
UpdatedTs	string	Date and time of return updated.
ErrorRecords	object[]	It will show the detailed information about the error status of Form 943 Records.
RecordId	Guid	Unique identifier of a record.
Sequence	string	A unique number given by an inbound application to identify failed records.
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.
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.

Request JSON

        {
  "Form943Records": [
    {
      "Sequence": null,
      "ReturnHeader": {
        "ReturnType": "FORM943",
        "TaxYr": "2019",
        "Business": {
          "BusinessId": null,
          "BusinessNm": "Span Tech",
          "TradeNm": null,
          "IsEIN": true,
          "EINorSSN": "987321312",
          "Email": "spantech@w3magix.com",
          "ContactNm": "ZohoCorp10",
          "Phone": "9865465465",
          "PhoneExtn": null,
          "Fax": null,
          "BusinessType": "EORG",
          "SigningAuthority": {
            "Name": "Zoho",
            "Phone": "9874654654",
            "BusinessMemberType": "PRESIDENT"
          },
          "KindOfEmployer": null,
          "KindOfPayer": null,
          "IsBusinessTerminated": false,
          "IsForeign": false,
          "USAddress": {
            "Address1": "123 main st",
            "Address2": null,
            "City": "RockHill",
            "State": "NC",
            "ZipCd": "27001"
          },
          "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": "1245174532"
          },
          "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": null,
          "IsSeasonalEmployer": false
        }
      },
      "ReturnData": {
        "Form943": {
          "PriorAddressInd": false,
          "EmployeeCnt": 1,
          "SocialSecurityTaxCashWagesAmt": 50000.0,
          "SocialSecurityTaxAmt": 6200.0,
          "MedicareTaxCashWagesAmt": 0.0,
          "MedicareTaxWithheldAmt": 0.0,
          "TotMedcrTaxCashWagesAddnlWhAmt": 0.0,
          "AddnlMedicareTaxWithholdingAmt": 0.0,
          "FederalIncomeTaxWithheldAmt": 0.0,
          "TotalTaxBeforeAdjustmentAmt": 6200.0,
          "CurrentYearAdjustmentAmt": 0.0,
          "TotalTaxAfterAdjustmentAmt": 6200.0,
          "PayrollTaxCreditAmt": 0.0,
          "Form8974": {
            "Form8974IncomeTaxDetails": [
              {
                "IncomeTaxPeriodEndDate": null,
                "IncomeTaxReturnFiledForm": null,
                "IncomeTaxReturnFiledDate": null,
                "Form6765EIN": null,
                "Form6765Line44Amt": 0.0,
                "PreviousPeriodRemainingCreditAmt": 0.0,
                "RemainingCredit": 0.0
              },
              {
                "IncomeTaxPeriodEndDate": null,
                "IncomeTaxReturnFiledForm": null,
                "IncomeTaxReturnFiledDate": null,
                "Form6765EIN": null,
                "Form6765Line44Amt": 0.0,
                "PreviousPeriodRemainingCreditAmt": 0.0,
                "RemainingCredit": 0.0
              },
              {
                "IncomeTaxPeriodEndDate": null,
                "IncomeTaxReturnFiledForm": null,
                "IncomeTaxReturnFiledDate": null,
                "Form6765EIN": null,
                "Form6765Line44Amt": 0.0,
                "PreviousPeriodRemainingCreditAmt": 0.0,
                "RemainingCredit": 0.0
              },
              {
                "IncomeTaxPeriodEndDate": null,
                "IncomeTaxReturnFiledForm": null,
                "IncomeTaxReturnFiledDate": null,
                "Form6765EIN": null,
                "Form6765Line44Amt": 0.0,
                "PreviousPeriodRemainingCreditAmt": 0.0,
                "RemainingCredit": 0.0
              },
              {
                "IncomeTaxPeriodEndDate": null,
                "IncomeTaxReturnFiledForm": null,
                "IncomeTaxReturnFiledDate": null,
                "Form6765EIN": null,
                "Form6765Line44Amt": 0.0,
                "PreviousPeriodRemainingCreditAmt": 0.0,
                "RemainingCredit": 0.0
              }
            ],
            "Line7": null,
            "Line8": null,
            "Line9": null,
            "Line10": null,
            "Line11": null,
            "PayerIndicatorType": null,
            "Line12": null
          },
          "TotalTaxAmt": 6200.0,
          "TotalTaxDepositAmt": 0.0,
          "BalanceDueAmt": 6200.0,
          "OverpaidAmt": 0.0,
          "OverPaymentRecoveryType": null
        },
        "IRSPaymentType": "CHECK_OR_MO",
        "IRSPayment": {
          "BankRoutingNum": null,
          "AccountType": null,
          "BankAccountNum": null,
          "Phone": null
        },
        "DepositScheduleType": {
          "DepositorType": "SEMIWEEKLY",
          "MonthlyDepositor": {
            "JanTaxLiability": 0.0,
            "FebTaxLiability": 0.0,
            "MarTaxLiability": 0.0,
            "AprTaxLiability": 0.0,
            "MayTaxLiability": 0.0,
            "JunTaxLiability": 0.0,
            "JulTaxLiability": 0.0,
            "AugTaxLiability": 0.0,
            "SepTaxLiability": 0.0,
            "OctTaxLiability": 0.0,
            "NovTaxLiability": 0.0,
            "DecTaxLiability": 0.0
          },
          "SemiWeeklyDepositor": {
            "Form943AJanMonthAmt": [
              {
                "Day": 1,
                "Amt": 3100.0
              }
            ],
            "Form943AJanMonthTotAmt": 3100.0,
            "Form943AFebMonthAmt": [
              {
                "Day": 1,
                "Amt": 3100.0
              }
            ],
            "Form943AFebMonthTotAmt": 3100.0,
            "Form943AMarMonthAmt": [
              {
                "Day": 1,
                "Amt": 0.0
              }
            ],
            "Form943AMarMonthTotAmt": 0.0,
            "Form943AAprMonthAmt": [
              {
                "Day": 1,
                "Amt": 0.0
              }
            ],
            "Form943AAprMonthTotAmt": 0.0,
            "Form943AMayMonthAmt": [
              {
                "Day": 1,
                "Amt": 0.0
              }
            ],
            "Form943AMayMonthTotAmt": 0.0,
            "Form943AJunMonthAmt": [
              {
                "Day": 1,
                "Amt": 0.0
              }
            ],
            "Form943AJunMonthTotAmt": 0.0,
            "Form943AJulMonthAmt": [
              {
                "Day": 1,
                "Amt": 0.0
              }
            ],
            "Form943AJulMonthTotAmt": 0.0,
            "Form943AAugMonthAmt": [
              {
                "Day": 1,
                "Amt": 0.0
              }
            ],
            "Form943AAugMonthTotAmt": 0.0,
            "Form943ASepMonthAmt": [
              {
                "Day": 1,
                "Amt": 0.0
              }
            ],
            "Form943ASepMonthTotAmt": 0.0,
            "Form943AOctMonthAmt": [
              {
                "Day": 1,
                "Amt": 0.0
              }
            ],
            "Form943AOctMonthTotAmt": 0.0,
            "Form943ANovMonthAmt": [
              {
                "Day": 1,
                "Amt": 0.0
              }
            ],
            "Form943ANovMonthTotAmt": 0.0,
            "Form943ADecMonthAmt": [
              {
                "Day": 1,
                "Amt": 0.0
              }
            ],
            "Form943ADecMonthTotAmt": 0.0
          },
          "TotalTaxLiabilityWholeYearAmt": 6200.0
        }
      }
    }
  ]
}

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
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279

Response JSON

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "SubmissionId": "050acfd2-0984-4645-b561-6e0e83fa53c6",
 "Form943Records": {
   "SuccessRecords": [
     {
       "Sequence": null,
       "RecordId": "9d07cfe3-6c1b-4647-8362-6f747deb61b9",
       "RecordStatus": "Created",
       "CreatedTs": "2020-03-12 06:52:43 -04:00",
       "UpdatedTs": "2020-03-12 06:52:43 -04:00"
     }
   ],
   "ErrorRecords": null
 },
 "Errors": null
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# Delete

Deletes 943 returns by Submission Ids and Record Ids.

DELETE Form943/Delete

Request Parameters

Field	Type	Description
SubmissionId	string	Unique identifier of a submission.
RecordIds	string	`Optional` List of record Ids to be deleted.

Response Parameters

Field	Type	Description
StatusCode	number	Returns the HTTP status codes like 200,300 etc.
StatusName	string	Name of the status code.
StatusMessage	string	Detailed status message.
SubmissionId	Guid	Unique identifier of a submission.
Form943Records	object	Pulls the Form 943 records with Success and Error statuses.
SuccessRecords	object[]	It will show the detailed information about the success status of Form 943 Records.
Sequence	string	A unique number given by an inbound application to identify failed records.
RecordId	Guid	Unique identifier of a record.
RecordStatus	string	Returns the status of the records.
CreatedTs	string	Date and time of return created.
UpdatedTs	string	Date and time of return updated.
ErrorRecords	object[]	It will show the detailed information about the error status of Form 943 Records
RecordId	Guid	Unique identifier of a record.
Sequence	string	A unique number given by an inbound application to identify failed records.
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.
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.

Request JSON

Form943/Delete?SubmissionId=4e38f23b-ff52-4cb7-8b43-c2d4fcf90be7&RecordIds=289f3cbf-040c-4e77-8803-6eff6148375e

Response JSON

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "SubmissionId": "4e38f23b-ff52-4cb7-8b43-c2d4fcf90be7",
 "Form943Records": {
   "SuccessRecords": [
     {
       "Sequence": "",
       "RecordId": "289f3cbf-040c-4e77-8803-6eff6148375e",
       "RecordStatus": "DELETED",
       "CreatedTs": "2/2/2020 1:46:16 AM",
       "UpdatedTs": "2/2/2020 1:47:13 AM"
     }
   ],
   "ErrorRecords": null
 },
 "Errors": null
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# DownloadForm8453EMP

Downloads Form 8453 EMP by Record Id.

GET Form943/DownloadForm8453EMP

Request Parameter

Field	Type	Description
RecordId	guid	Unique identifier of a record.

Response Parameters

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.
RecordId	Guid	Unique identifier of a record
Pdf	byte[]	Pulls the byte array of Form-8453 pdf records with Success and Error statuses
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.

Request JSON

Form943/DownloadForm8453EMP?RecordId=eed7cf65-088e-4eba-800a-dcd54c0d05bb

Response JSON

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "RecordId": "eed7cf65-088e-4eba-800a-dcd54c0d05bb",
 "Form8453EMPPdf": "QEA",
  "Errors": null
}

1
2
3
4
5
6
7
8

# Get

Gets information of 943 returns by Submission Id.

GET Form943/Get

Request Parameters

Field	Type	Description
SubmissionId	guid	Unique identifier of a submission

Response Parameters

Field	Type	Description
StatusCode	number	Returns the HTTP status codes like 200,300 etc.
StatusName	string	Name of the status code.
StatusMessage	string	Detailed status message.
SubmissionId	guid	Unique identifier of a submission
Form943Records	object[]	Employer's Form 943 information.
RecordId	guid	Unique identifier of a record
ReturnHeader	object	Identifies the supporting details of Form 943.
ReturnType	string	Type of the return filed.
TaxYr	string	The Tax year for which Form 943 has been filed.
Business	object	Business Details
BusinessNm	string	Name of the business
TradeNm	string	`Optional` Name under which the business operates
IsEIN	Boolean	When true, identifies the business with an EIN.
EINorSSN	string	Employer Identification Number (EIN). When IsEIN is false, Social Security Number (SSN).
Email	string	Email address of the Business
ContactNm	string	Name of the person who can be contacted by the IRS
Phone	string	Contact number of the business with area code
PhoneExtn	string	`Optional` Extension of the business phone number
Fax	string	`Optional` Fax number of the Business
BusinessType	string	Type of business.
SigningAuthority	object	Details of the person who is authorized to sign the return
Name	string	Name of the signing authority.
Phone	string	Phone number of the signing authority.
BusinessMemberType	string	Business title of the signing authority
KindOfEmployer	string	Identifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series.
KindOfPayer	string	Kind Of Payer based on the Employer's Federal Tax Return.
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, US address of the business
Address1	string	Employer/Payer's US address (street address or post office box of that locality)
Address2	string	`Optional` Employer/Payer's suite or apartment
City	string	Employer/Payer's city
State	string	Employer/Payer's state
ZipCd	string	Employer/Payer's zip code
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).
Address2	string	`Optional` Employer/Payer's suite or apartment
City	string	Employer/Payer's city
ProvinceOrStateNm	string	Employer/Payer's province or state name
Country	string	Employer/Payer's country
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
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.
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 Buiness 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)
Address2	string	`Optional` Employer/Payer's suite or apartment
City	string	Employer/Payer's city
State	string	Employer/Payer's state
ZipCd	string	Employer/Payer's zip code
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)
Address2	string	`Optional` Employer/Payer's suite or apartment
City	string	Employer/Payer's city
ProvinceOrStateNm	string	Employer/Payer's province or state name
Country	string	Employer/Payer's country
PostalCd	string	Employer/Payer's postal code
ReturnData	object	Identifies the Form 943 data
Form943	object	Form 943, Employer’s QUARTERLY Federal Tax Return
PriorAddressInd	Boolean	When true, If address is different from prior return.
EmployeeCnt	number	Gets the number of Employees who has received wages, tips, or other compensation for the pay period. Line 1
SocialSecurityTaxCashWagesAmt_Col1	number	Gets the taxable social security wages amount. Line 2
SocialSecurityTaxAmt	number	Gets the taxable social security tips amount. Line 3
MedicareTaxCashWagesAmt	number	Gets the taxable medicare wages and tips amount. Line 4
MedicareTaxWithheldAmt	number	Gets the taxable medicare withheld amount. Line 5
TotMedcrTaxCashWagesAddnlWhAmt	number	Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Line 6
AddnlMedicareTaxWithholdingAmt	number	Gets additional Medicare Tax withholding amount. Line 7
FederalIncomeTaxWithheldAmt	number	Gets the tax on Federal Income Tax withheld. Line 8
TotalTaxBeforeAdjustmentAmt	number	Gets the total taxes beofre adjustments by adding lines 3, 5,7 and 8. Line 9
CurrentYearAdjustmentAmt	number	Gets the tax on current year's adjustments. Line 10
TotalTaxAfterAdjustmentAmt	number	Gets the Total taxes Security after adding adjustments by line 9 adjusted by line 10. Line 11
PayrollTaxCreditAmt	number	Gets the tax for qualified small business payroll tax credits.line 12
TotalTaxAmt	number	Gets the Total taxes after adjustments and credits by subtracting line 12 from line 11.Line 13.
TotalTaxDepositAmt	number	Gets the amount of total tax deposits including overpayment applied from prior year and Form 943-x. Line 14.
BalanceDueAmt	number	Gets the amount of difference between line 13 and line 14, if line 13 is greater than line 14. Line 15.
OverpaidAmt	number	Gets the amount difference between line 14 and line 13, if line 14 is greater than line 13. Line 16.
IsOverPayment	Boolean	When true, identifies the Line 12 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, 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.
Line8	number	Gets the total amount of social security tax on wages from Form 943, line 5a, column 2; Form 943, line 3; or Form 944, line 4a, column 2. Part 2 Line 8.
Line9	number	Gets the total amount of social security tax on tips from Form 943, line 5b, column 2; or Form 944, line 4b, column 2. Part 2 Line 9.
Line10	number	Gets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10.
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.
PayerIndicatorType	string	Identifies if you are a Third-party payer of sick pay or received a Section 3121(q) Notice and Demand
Line12	number	Gets the credit amount smaller of line 7 or line 11. Also, this amount entered on Form 943 (943-PR or 943-SS), line 11; Form 943 (943-PR), line 12; or Form 944 (944(SP)), line 8
TotTaxDepositAmt	number	Gets the total deposits for the quarter, including overpayment amount applied from a prior quarter and overpayments applied by filing Form 943-X, 943-X(PR), 944-X, or 944-X(SP) filed in the current quarter. Line 13
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.
FilerType	string	Type of Form 943 filer
IRSPaymentType	string	EFW, EFTPS, Check or 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 (Checking or Saving) of EFW payment
BankAccountNum	string	Bank Account Number of EFW payment
Phone	string	Phone of EFW payment
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
MonthlyDepositor	object	Line 16, Option 2. Monthly Schedule Depositor
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.
TaxLiabilityTotalAmt	number	Total tax liability amount.
SemiWeeklyDepositor	object	Line 16, Option 3. SemiWeekly Depositor
Form943AJanMonthAmt	object[]	Tax Liability for January in Form 943 A.
Day	string	Tax Lability 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	. Size Range: 0-99999999999999.99
Form943AJanMonthTotAmt	object[]	Total Tax Liability for January in Form 943 A.
Form943AFebMonthAmt	object[]	Tax Liability for February in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AFebMonthTotAmt	object[]	Total Tax Liability for February in Form 943 A.
Form943AMarMonthAmt	object[]	Tax Liability for March in Form 943 A.
Day	string	Tax Lability 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	. Size Range: 0-99999999999999.99
Form943AJMarMonthTotAmt	object[]	Total Tax Liability for March in Form 943 A.
Form943AAprMonthAmt	object[]	Tax Liability for April in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AAprMonthTotAmt	object[]	Total Tax Liability for April in Form 943 A.
Form943AMayMonthAmt	object[]	Tax Liability for May in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AMayMonthTotAmt	object[]	Total Tax Liability for May in Form 943 A.
Form943AJunMonthAmt	object[]	Tax Liability for Jume in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AJunMonthTotAmt	object[]	Total Tax Liability for June in Form 943 A.
Form943AJulMonthAmt	object[]	Tax Liability for July in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AJulMonthTotAmt	object[]	Total Tax Liability for July in Form 943 A.
Form943AAugMonthAmt	object[]	Tax Liability for August in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AAugMonthTotAmt	object[]	Total Tax Liability for August in Form 943 A.
Form943ASepMonthAmt	object[]	Tax Liability for September in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943ASepMonthTotAmt	object[]	Total Tax Liability for September in Form 943 A.
Form943AOctMonthAmt	object[]	Tax Liability for October in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AOctMonthTotAmt	object[]	Total Tax Liability for October in Form 943 A.
Form943ANovMonthAmt	object[]	Tax Liability for November in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943ANovMonthTotAmt	object[]	Total Tax Liability for November in Form 943 A.
Form943ADecMonthAmt	object[]	Tax Liability for December in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943ADecMonthTotAmt	object[]	Total Tax Liability for December in Form 943 A.
ReturnNumber	string	Unique number of a return
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.

Request JSON

"Form943/Get?submissionId=f2fee2f8-74bf-4e1d-9239-399e76929475"

Response JSON

          {
    "StatusCode": 200,
    "StatusName": "Ok",
    "StatusMessage": "Successful API call",
    "SubmissionId": "2f430962-2278-4a3c-8310-02298004a375",
    "Form943Records": [
        {
            "RecordId": "ba073cc7-ca7e-4518-a932-16a06d89430b",
            "ReturnHeader": {
                "ReturnType": "Form943",
                "TaxYr": "2019",
                "Business": {
                    "BusinessId": "2846e02d-dceb-4dd2-9039-a53a8bd2ee35",
                    "BusinessNm": "Rhonda Agri LLC",
                    "TradeNm": null,
                    "IsEIN": true,
                    "EINorSSN": "123456789",
                    "Email": "rhondas.r@agrillc.com",
                    "ContactNm": "Rhonda Charles",
                    "Phone": "1234567890",
                    "PhoneExtn": null,
                    "Fax": "(123) 456-7890",
                    "BusinessType": "CORP",
                    "SigningAuthority": {
                        "Name": "Rhonda Charles",
                        "Phone": "1234567890",
                        "BusinessMemberType": "PRESIDENT"
                    },
                    "KindOfEmployer": null,
                    "KindOfPayer": null,
                    "IsBusinessTerminated": false,
                    "IsForeign": false,
                    "USAddress": {
                        "Address1": "123 Kinsley Rd",
                        "Address2": "Main St",
                        "City": "Seattle",
                        "State": "WA",
                        "ZipCd": "98944"
                    },
                    "ForeignAddress": {
                        "Address1": null,
                        "Address2": null,
                        "City": null,
                        "ProvinceOrStateNm": null,
                        "Country": null,
                        "PostalCd": null
                    }
                },
                "IsThirdPartyDesignee": false,
                "ThirdPartyDesignee": null,
                "SignatureDetails": {
                    "SignatureType": "ONLINE_SIGN_PIN",
                    "OnlineSignaturePIN": {
                        "PIN": "1234567899"
                    },
                    "ReportingAgentPIN": null,
                    "Form8453EMP": null
                },
                "BusinessStatusDetails": {
                    "IsBusinessClosed": false,
                    "BusinessClosedDetails": null,
                    "IsBusinessTransferred": false,
                    "BusinessTransferredDetails": null,
                    "IsSeasonalEmployer": false
                }
            },
            "ReturnData": {
                "Form943": {
                    "EmployeeCnt": 5,
                    "SocialSecurityTaxCashWagesAmt": 100.00,
                    "SocialSecurityTaxAmt": 100.00,
                    "MedicareTaxCashWagesAmt": 100.00,
                    "MedicareTaxWithheldAmt": 100.00,
                    "TotMedcrTaxCashWagesAddnlWhAmt": 100.00,
                    "AddnlMedicareTaxWithholdingAmt": 100.00,
                    "FederalIncomeTaxWithheldAmt": 100.00,
                    "TotalTaxBeforeAdjustmentAmt": 100.00,
                    "CurrentYearAdjustmentAmt": 100.00,
                    "TotalTaxAfterAdjustmentAmt": 100.00,
                    "PayrollTaxCreditAmt": 0.00,
                    "Form8974": null,
                    "TotalTaxAmt": 2000.00,
                    "TotalTaxDepositAmt": 20000.00,
                    "BalanceDueAmt": 100.00,
                    "OverpaidAmt": 18000.00,
                    "OverPaymentRecoveryType": ""
                },
                "IRSPaymentType": null,
                "IRSPayment": null,
                "FinalPayRoll": null,
                "DepositScheduleType": {
                    "DepositorType": "MINTAXLIABILITY",
                    "MonthlyDepositor": null,
                    "SemiWeeklyDepositor": null,
                    "TotalTaxLiabilityWholeYearAmt": 3000.00
                }
            },
            "ReturnNumber": "6U000582013126-4"
        }
    ],
    "Errors": null
}

# GetPDF

Request a PDF download of 943 to be made available through Webhooks

GET Form943/GetPDF

Request Parameters

Field	Type	Description
SubmissionId	string	Unique identifier of a submission
RecordIds	string	`Optional` List of record Ids to be downloaded.

Response Parameters

Field	Type	Description
StatusCode	number	Returns the HTTP status codes like 200,300 etc.
StatusName	string	Name of the status code.
StatusMessage	string	Detailed status message.
SubmissionId	Guid	Unique identifier of a submission
Form943pdfRecords	object[]	Form943pdfRecords Object
RecordId	Guid	Unique identifier of a record
Form943pdf	string	Returns the record ID with success message after generating a PDF.
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.

Request JSON

Form943/GetPDF?SubmissionId=7f9cb1ab-f90b-4358-ae5f-acfe19617d96&RecordIds=22af7b4b-42f2-4e68-a9ac-743d2fd76636

Response JSON

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "SubmissionId": "7f9cb1ab-f90b-4358-ae5f-acfe19617d96",
 "Form943pdfRecords": [
   {
     "RecordId": "22af7b4b-42f2-4e68-a9ac-743d2fd76636",
     "Form943pdf": "We've successfully received your request to generate PDF. You will be notified with the URL to download the PDF."
   }
 ],
 "Errors": null
}

1
2
3
4
5
6
7
8
9
10
11
12
13

# List

Lists Form 943s created for a date range.

GET Form943/List

Request Parameters

Field	Type	Description
BusinessId	guid	`Optional` Unique identifier of a business.
EIN	string	`Optional` Employer Identification Number.
Page	number	`Optional` Pulls the page number of the page selected
PageSize	number	`Optional` Number of 943 records to be listed in each page
EfileStatus	string	`Optional` List the 943 records based on the status
FromDate	string	`Optional` List 943 records created from
ToDate	string	`Optional` List 943 records created up to

Response Parameters

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.
Form943RecordList	object[]	Returns detailed information of the Form 943 records.
SubmissionId	guid	Unique identifier of a submission
BusinessId	guid	Unique Identifier of the business
BusinessNm	string	Name of the business
EIN	string	Employer Identification Number
BusinessType	string	Type of business.
RecordId	guid	Unique identifier of a record
TaxYr	string	Tax year for which Form 943 needs to be filed
IRSPaymentType	string	Payment type to make payments pay the IRS. Choose from EFW, EFTPS, Check or Money Order
ReturnType	string	Type of the return to be filed. Enter value as FORM943
EFileStatus	string	List the 943 records based on the status.
TotalRecords	number	Total number of records.
TotalPages	number	Total number of pages.
Page	number	Pulls the page number of the page selected
PageSize	number	Number of 943 records to be listed in each page.
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.

Request JSON

"Form943/List?BusinessId=c5beb833-2ce4-4293-9772-6c94d37173f2&EIN=005498751&Page=1&PageSize=10&EfileStatus=null&FromDate=01/01/2020&ToDate=02/10/2020"

Response JSON

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "Form943RecordList": [
   {
     "SubmissionId": "7f9cb1ab-f90b-4358-ae5f-acfe19617d96",
     "BusinessId": "c5beb833-2ce4-4293-9772-6c94d37173f2",
     "BusinessNm": "Rhona Agri Company",
     "EIN": "11-1234567",
     "BusinessType": "Estate",
     "RecordId": "22af7b4b-42f2-4e68-a9ac-743d2fd76636",
     "TaxYr": "2019",
     "IRSPaymentType": "EFTPS",
     "ReturnType": "ORIGINAL",
     "EFileStatus": "CREATED"
   }
 ],
 "TotalRecords": 1,
 "TotalPages": 1,
 "Page": 1,
 "PageSize": 10,
 "Errors": null
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24

# Status

Gets the status of the 943 returns by Submission Id and Record Ids.

GET Form943/Status

Request Parameters

Field	Type	Description
SubmissionId	string	Unique identifier of a submission
RecordIds	string	`Optional` Gets the status for a list of Record IDs
ReturnType	string	`Optional` Type of the return to be filed. Enter value as FORM943
EIN	string	`Optional` Employer Identification Number
TaxYear	string	`Optional` Tax year for which Form 943 needs to be filed

Response Parameters

Field	Type	Description
StatusCode	number	Returns the HTTP status codes like 200,300 etc.
StatusName	string	Name of the status code.
StatusMessage	string	Detailed status message.
SubmissionId	Guid	Unique identifier of a submission.
Form943Records	object	Pulls the Form 943 records with Success and Error statuses.
SuccessRecords	object[]	It will show the detailed information about the success status of Form 943 Records.
Sequence	string	A unique number given by an inbound application to identify failed records.
RecordId	Guid	Unique identifier of a record.
RecordStatus	string	Returns the status of the records.
CreatedTs	string	Date and time of return created.
UpdatedTs	string	Date and time of return updated.
ErrorRecords	object[]	It will show the detailed information about the error status of Form 943 Records
RecordId	Guid	Unique identifier of a record.
Sequence	string	A unique number given by an inbound application to identify failed records.
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.
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.

Request JSON

Form943/Status?SubmissionId=7f9cb1ab-f90b-4358-ae5f-acfe19617d96&RecordIds=22af7b4b-42f2-4e68-a9ac-743d2fd76636&ReturnType=FORM943&EIN=005498751&TaxYear=2019

Response JSON

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "SubmissionId": "7f9cb1ab-f90b-4358-ae5f-acfe19617d96",
 "Form943Records": {
   "SuccessRecords": [
     {
       "Sequence": null,
       "RecordId": "22af7b4b-42f2-4e68-a9ac-743d2fd76636",
       "RecordStatus": "Created",
       "CreatedTs": "2020-02-02 01:29:56 -04:00",
       "UpdatedTs": "2020-02-02 01:29:56 -04:00"
     }
   ],
   "ErrorRecords": null
 },
 "Errors": null
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# Transmit

Transmits the Form 943 to the IRS after validation.

POST Form943/Transmit

Request Parameters

Field	Type	Description
SubmissionId	guid	Unique identifier of a submission
RecordIds	guid[]	`Optional` List of record Ids to be transmitted.

Response Parameters

Field	Type	Description
StatusCode	number	Returns the HTTP status codes like 200,300 etc.
StatusName	string	Name of the status code.
StatusMessage	string	Detailed status message.
SubmissionId	Guid	Unique identifier of a submission.
Form943Records	object	Pulls the Form 943 records with Success and Error statuses.
SuccessRecords	object[]	It will show the detailed information about the success status of Form 943 Records.
Sequence	string	A unique number given by an inbound application to identify failed records.
RecordId	Guid	Unique identifier of a record.
RecordStatus	string	Returns the status of the records.
CreatedTs	string	Date and time of return created.
UpdatedTs	string	Date and time of return updated.
ErrorRecords	object[]	It will show the detailed information about the error status of Form 943 Records.
RecordId	Guid	Unique identifier of a record.
Sequence	string	A unique number given by an inbound application to identify failed records.
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.
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.

Request JSON

{
 "SubmissionId": "f2fee2f8-74bf-4e1d-9239-399e76929475",
 "RecordIds": [
   "ed6bc24b-189d-419b-9224-2dd2bf3b7467"
 ]
}

1
2
3
4
5
6

Response JSON

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "SubmissionId": "f2fee2f8-74bf-4e1d-9239-399e76929475",
 "Form943Records": {
   "SuccessRecords": [
     {
       "Sequence": "",
       "RecordId": "ed6bc24b-189d-419b-9224-2dd2bf3b7467",
       "RecordStatus": "Transmitted",
       "CreatedTs": "2020-02-02 03:06:07 -04:00",
       "UpdatedTs": "2020-02-02 03:57:35 -04:00"
     }
   ],
   "ErrorRecords": null
 },
 "Errors": null
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# Update

Updates information of Form 943s by Submission Id and Record Id.

PUT Form943/Update

Request Parameters

Field	Type	Description
SubmissionId	guid	Unique identifier of a submission.
Form943Records	object[]	Collection of objects to update Form 943 records
RecordId	guid	Unique identifier of a record.
Sequence	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. Allowed values: "FORM943"
TaxYr	string	The Tax year for which Form 943 needs to be filed.
Business	object	Business Details
BusinessId	guid	Business Identifier (Autogenerated).
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
Email	string	Email address of the Business Size Range: ..40
ContactNm	string	Name of the person who can be contacted by the IRS Size Range: ..27
Phone	string	Contact number of the business with area code Size Range: 10
PhoneExtn	string	`Optional` Extension of the business phone number Size Range: ..5
Fax	string	`Optional` Fax number of the Business Size Range: 10
BusinessType	string	Type of business. Optional for W-2/1099 and mandatory for 94X series Size Range: ..4 Allowed values: "ESTE", "PART", "CORP", "EORG", "SPRO"
SigningAuthority	object	Details of the person who is authorized to sign the return
Name	string	Name of the signing authority. Size Range: ..35
Phone	string	Phone number of the signing authority. Size Range: 10
BusinessMemberType	string	Business title of the signing authority Size Range: 5..29 Allowed values: "CORPORATESECRETARY", "SECRETARYTREASURER", "PARTNER", "GENERALPARTNER", "LIMITEDPARTNER", "LLCMEMBER", "MANAGINGMEMBER", "MANAGER", "TAXMATTERPARTNER", "PRESIDENT", "VICEPRESIDENT", "CORPORATETREASURER", "TREASURER", "ASSISTANTTREASURER", "CHIEFACCOUNTINGOFFICER", "CHIEFEXECUTIVEOFFICER", "CHIEFFINANCIALOFFICER", "TAXOFFICER", "CHIEFOPERATINGOFFICER", "CORPORATEOFFICER", "EXECUTIVEDIRECTOR", "DIRECTOR", "CHAIRMAN", "EXECUTIVEADMINISTRATOR", "RECEIVER", "PASTOR", "ASSISTANTTORELIGIOUSLEADER", "REVEREND", "PRIEST", "MINISTER", "RABBI", "LEADEROFRELIGIOUSORGANIZATION", "SECRETARY", "DIRECTOROFTAXATION", "DIRECTOROFPERSONNEL", "ADMINISTRATOR", "EXECUTOR", "TRUSTEE", "FIDUCIARY", "OWNER", "SOLEPROPRIETOR", "MEMBER", "SOLEMEMBER"
KindOfEmployer	string	Identifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series. Allowed values: "FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"
KindOfPayer	string	Kind Of Payer based on the Employer's Federal Tax Return. Allowed values: "REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"
IsBusinessTerminated	Boolean	When true, identifies the business as terminated.
IsForeign	Boolean	When true, identifies the business address with a foreign address.
USAddress	object	if IsForeign is false, pass US address of the business
Address1	string	Employer/Payer's US address (street address or post office box of that locality) Size Range: ..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 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
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 Size Range: 2 Allowed values: "US", "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
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
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 Buiness 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 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
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 Size Range: 2 Allowed values: "US", "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
ReturnData	object	Identifies the Form 943 data
Form943	object	Form 943, Employer’s QUARTERLY Federal Tax Return
PriorAddressInd	Boolean	When true, If address is different from prior return.
EmployeeCnt	number	Gets the number of Employees who has received wages, tips, or other compensation for the pay period. Line 1
SocialSecurityTaxCashWagesAmt_Col1	number	Gets the taxable social security wages amount. Line 2 Size Range: 0-99999999999999.99
SocialSecurityTaxAmt	number	Gets the taxable social security tips amount. Line 3 Size Range: 0-99999999999999.99
MedicareTaxCashWagesAmt	number	Gets the taxable medicare wages and tips amount. Line 4 Size Range: 0-99999999999999.99
MedicareTaxWithheldAmt	number	Gets the taxable medicare withheld amount. Line 5 Size Range: 0-99999999999999.99
TotMedcrTaxCashWagesAddnlWhAmt	number	Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Line 6 Size Range: 0-99999999999999.99
AddnlMedicareTaxWithholdingAmt	number	Gets additional Medicare Tax withholding amount. Line 7 Size Range: 0-99999999999999.99
FederalIncomeTaxWithheldAmt	number	Gets the tax on Federal Income Tax withheld. Line 8 Size Range: 0-99999999999999.99
TotalTaxBeforeAdjustmentAmt	number	Gets the total taxes beofre adjustments by adding lines 3, 5,7 and 8. Line 9 Size Range: 0-99999999999999.99
CurrentYearAdjustmentAmt	number	Gets the tax on current year's adjustments. Line 10 Size Range: 0-99999999999999.99
TotalTaxAfterAdjustmentAmt	number	Gets the Total taxes Security after adding adjustments by line 9 adjusted by line 10. Line 11 Size Range: 0-99999999999999.99
PayrollTaxCreditAmt	number	Gets the tax for qualified small business payroll tax credits.line 12 Size Range: 0-99999999999999.99
TotalTaxAmt	number	Gets the Total taxes after adjustments and credits by subtracting line 12 from line 11.Line 13. Size Range: -99999999999999.99-99999999999999.99
TotalTaxDepositAmt	number	Gets the amount of total tax deposits including overpayment applied from prior year and Form 943-x. Line 14. Size Range: -99999999999999.99-99999999999999.99
BalanceDueAmt	number	Gets the amount of difference between line 13 and line 14, if line 13 is greater than line 14. Line 15. Size Range: -99999999999999.99-99999999999999.99
OverpaidAmt	number	Gets the amount difference between line 14 and line 13, if line 14 is greater than line 13. Line 16. Size Range: -99999999999999.99-99999999999999.99
IsOverPayment	Boolean	When true, identifies the Line 12 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, 1065, 1120, 1120-F, or 1120S. Part 1 Column (b)
IncomeTaxReturnFiledDate	string	Gets the income tax return filing date shown in column (b). Part 1 Column (c)
Form6765EIN	string	Gets the EIN used on Form 6765 if the EIN used on Form 8974 doesn't match with the EIN on Form 6765. Part 1 Column (d) Size Range: 9
Form6765Line44Amt	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 943, 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 943, line 5b, column 2; or Form 944, line 4b, column 2. Part 2 Line 9. Size Range: 0-99999999999999.99
Line10	number	Gets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10. Size Range: 0-99999999999999.99
Line11	number	Gets the amount of line 10 multiplied by 50% (0.50) on line 11. If you’re a third-party payer of sick pay or you received a Section 3121(q) Notice and Demand, check the applicable box on line 11. Size Range: 0-99999999999999.99
PayerIndicatorType	string	Identifies if you are a Third-party payer of sick pay or received a Section 3121(q) Notice and Demand
Line12	number	Gets the credit amount smaller of line 7 or line 11. Also, this amount entered on Form 943 (943-PR or 943-SS), line 11; Form 943 (943-PR), line 12; or Form 944 (944(SP)), line 8 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 943-X, 943-X(PR), 944-X, or 944-X(SP) filed in the current quarter. Line 13 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"
FilerType	string	Type of Form 943 filer
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 (Checking or Saving) of EFW payment
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 16, Option 2. Monthly Schedule Depositor
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.
TaxLiabilityTotalAmt	number	Total tax liability amount. Size Range: 0-99999999999999.99
SemiWeeklyDepositor	object	Line 16, Option 3. SemiWeekly Depositor
Form943AJanMonthAmt	object[]	Tax Liability for January in Form 943 A.
Day	string	Tax Lability 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	. Size Range: 0-99999999999999.99
Form943AJanMonthTotAmt	object[]	Total Tax Liability for January in Form 943 A.
Form943AFebMonthAmt	object[]	Tax Liability for February in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AFebMonthTotAmt	object[]	Total Tax Liability for February in Form 943 A.
Form943AMarMonthAmt	object[]	Tax Liability for March in Form 943 A.
Day	string	Tax Lability 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	. Size Range: 0-99999999999999.99
Form943AJMarMonthTotAmt	object[]	Total Tax Liability for March in Form 943 A.
Form943AAprMonthAmt	object[]	Tax Liability for April in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AAprMonthTotAmt	object[]	Total Tax Liability for April in Form 943 A.
Form943AMayMonthAmt	object[]	Tax Liability for May in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AMayMonthTotAmt	object[]	Total Tax Liability for May in Form 943 A.
Form943AJunMonthAmt	object[]	Tax Liability for Jume in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AJunMonthTotAmt	object[]	Total Tax Liability for June in Form 943 A.
Form943AJulMonthAmt	object[]	Tax Liability for July in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AJulMonthTotAmt	object[]	Total Tax Liability for July in Form 943 A.
Form943AAugMonthAmt	object[]	Tax Liability for August in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AAugMonthTotAmt	object[]	Total Tax Liability for August in Form 943 A.
Form943ASepMonthAmt	object[]	Tax Liability for September in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943ASepMonthTotAmt	object[]	Total Tax Liability for September in Form 943 A.
Form943AOctMonthAmt	object[]	Tax Liability for October in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AOctMonthTotAmt	object[]	Total Tax Liability for October in Form 943 A.
Form943ANovMonthAmt	object[]	Tax Liability for November in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943ANovMonthTotAmt	object[]	Total Tax Liability for November in Form 943 A.
Form943ADecMonthAmt	object[]	Tax Liability for December in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943ADecMonthTotAmt	object[]	Total Tax Liability for December in Form 943 A.

Response Parameters

Field	Type	Description
StatusCode	number	Returns the HTTP status codes like 200,300 etc.
StatusName	string	Name of the status code.
StatusMessage	string	Detailed status message.
SubmissionId	Guid	Unique identifier of a submission.
Form943Records	object	Pulls the Form 943 records with Success and Error statuses.
SuccessRecords	object[]	It will show the detailed information about the success status of Form 943 Records.
Sequence	string	A unique number given by an inbound application to identify failed records.
RecordId	Guid	Unique identifier of a record.
RecordStatus	string	Returns the status of the records.
CreatedTs	string	Date and time of return created.
UpdatedTs	string	Date and time of return updated.
ErrorRecords	object[]	It will show the detailed information about the error status of Form 943 Records.
RecordId	Guid	Unique identifier of a record.
Sequence	string	A unique number given by an inbound application to identify failed records.
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.
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.

Request JSON

      {
 "Form943Records": [
   {
     "Sequence": null,
     "ReturnHeader": {
       "ReturnType": "Form943",
       "TaxYr": "2019",
       "Business": {
         "BusinessId": null,
         "BusinessNm": "Fabi Agri Products LLC",
         "TradeNm": null,
         "IsEIN": true,
         "EINorSSN": "123456789",
         "Email": "fabian@agrollc.com",
         "ContactNm": "Fabian Smith",
         "Phone": "1234567890",
         "PhoneExtn": null,
         "Fax": "1234567890",
         "BusinessType": "CORP",
         "SigningAuthority": {
           "Name": "Fabian Smith",
           "Phone": "1234567890",
           "BusinessMemberType": "PRESIDENT"
         },
         "KindOfEmployer": null,
         "KindOfPayer": null,
         "IsBusinessTerminated": false,
         "IsForeign": false,
         "USAddress": {
           "Address1": "17 Kinsley Rd",
           "Address2": "Main St",
           "City": "Seattle",
           "State": "WA",
           "ZipCd": "98944"
         },
         "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": "1234567899"
         },
         "ReportingAgentPIN": {
           "PIN": null
         },
         "Form8453EMP": null
       },
       "BusinessStatusDetails":{
         "IsBusinessClosed": false
		  }
     },
     "ReturnData": {
       "Form943": {
         "EmployeeCnt": 2,
         "SocialSecurityTaxCashWagesAmt": 200.0,
         "SocialSecurityTaxAmt": 200.0,
         "MedicareTaxCashWagesAmt": 200.0,
         "MedicareTaxWithheldAmt": 200.0,
         "TotMedcrTaxCashWagesAddnlWhAmt": 200.0,
         "AddnlMedicareTaxWithholdingAmt": 100.0,
         "FederalIncomeTaxWithheldAmt": 100.0,
         "TotalTaxBeforeAdjustmentAmt": 100.0,
         "CurrentYearAdjustmentAmt": 100.0,
         "TotalTaxAfterAdjustmentAmt": 100.0,
         "PayrollTaxCreditAmt": 0,
         "Form8974": {
           "Form8974IncomeTaxDetails": [
             {
               "IncomeTaxPeriodEndDate": null,
               "IncomeTaxReturnFiledForm": null,
               "IncomeTaxReturnFiledDate": null,
               "Form6765EIN": null,
               "Form6765Line44Amt": 0.0,
               "PreviousPeriodRemainingCreditAmt": 0.0,
               "RemainingCredit": 0.0
             },
             {
               "IncomeTaxPeriodEndDate": null,
               "IncomeTaxReturnFiledForm": null,
               "IncomeTaxReturnFiledDate": null,
               "Form6765EIN": null,
               "Form6765Line44Amt": 0.0,
               "PreviousPeriodRemainingCreditAmt": 0.0,
               "RemainingCredit": 0.0
             },
             {
               "IncomeTaxPeriodEndDate": null,
               "IncomeTaxReturnFiledForm": null,
               "IncomeTaxReturnFiledDate": null,
               "Form6765EIN": null,
               "Form6765Line44Amt": 0.0,
               "PreviousPeriodRemainingCreditAmt": 0.0,
               "RemainingCredit": 0.0
             },
             {
               "IncomeTaxPeriodEndDate": null,
               "IncomeTaxReturnFiledForm": null,
               "IncomeTaxReturnFiledDate": null,
               "Form6765EIN": null,
               "Form6765Line44Amt": 0.0,
               "PreviousPeriodRemainingCreditAmt": 0.0,
               "RemainingCredit": 0.0
             },
             {
               "IncomeTaxPeriodEndDate": null,
               "IncomeTaxReturnFiledForm": null,
               "IncomeTaxReturnFiledDate": null,
               "Form6765EIN": null,
               "Form6765Line44Amt": 0.0,
               "PreviousPeriodRemainingCreditAmt": 0.0,
               "RemainingCredit": 0.0
             }
           ],
           "Line7": null,
           "Line8": null,
           "Line9": null,
           "Line10": null,
           "Line11": null,
           "PayerIndicatorType": null,
           "Line12": null
         },
         "TotalTaxAmt": 2000.0,
         "TotalTaxDepositAmt": 20000.0,
         "BalanceDueAmt": 100.0,
         "OverpaidAmt": 0.0,
         "OverPaymentRecoveryType": null
       },
       "IRSPaymentType": null,
       "IRSPayment": {
         "BankRoutingNum": null,
         "AccountType": null,
         "BankAccountNum": null,
         "Phone": null
       },
       "FinalPayRoll": {
         "PersonNm": 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
         }
       },
       "DepositScheduleType": {
         "DepositorType": "SEMIWEEKLY",
         "MonthlyDepositor": {
           "JanTaxLiability": 0.0,
           "FebTaxLiability": 0.0,
           "MarTaxLiability": 0.0,
           "AprTaxLiability": 0.0,
           "MayTaxLiability": 0.0,
           "JunTaxLiability": 0.0,
           "JulTaxLiability": 0.0,
           "AugTaxLiability": 0.0,
           "SepTaxLiability": 0.0,
           "OctTaxLiability": 0.0,
           "NovTaxLiability": 0.0,
           "DecTaxLiability": 0.0
         },
         "SemiWeeklyDepositor": {
           "Form943AJanMonthAmt": [
             {
               "Day": 9,
               "Amt": 100.0
             },
             {
               "Day": 0,
               "Amt": 0.0
             },
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AFebMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             },
             {
               "Day": 0,
               "Amt": 0.0
             },
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AMarMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AAprMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AMayMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AJunMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AJulMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AAugMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943ASepMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AOctMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943ANovMonthAmt": [
             {
               "Day": 3,
               "Amt": 2000.0
             }
           ],
           "Form943ADecMonthAmt": [
             {
               "Day": 2,
               "Amt": 1000.0
             }
           ]
         },
         "TotalTaxLiabilityWholeYearAmt": 3000.0
       }
    },
     "RecordId": "1028b3c6-2fd9-479e-accf-1e0bbd867dd5"
   }
 ],
 "SubmissionId": "e49ac1c5-0feb-4494-b9d5-1d23a3d1f16c"
}

Response JSON

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "SubmissionId": "f2fee2f8-74bf-4e1d-9239-399e76929475",
 "Form943Records": {
   "SuccessRecords": [
     {
       "Sequence": 01,
       "RecordId": "ed6bc24b-189d-419b-9224-2dd2bf3b7467",
       "RecordStatus": "Created",
       "CreatedTs": "2020-02-02 03:06:07 -04:00",
       "UpdatedTs": "2020-02-02 03:06:07 -04:00"
     }
   ],
   "ErrorRecords": null
 },
 "Errors": null
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# UploadForm8453EMP

Uploads signed Form 8453 EMP by Record Id.

POST Form943/UploadForm8453EMP

Request Parameters

Field	Type	Description
RecordId	guid	Unique identifier of a record
Form8453EMPPdf	byte[]	Byte array of Form-8453 pdf

Response Parameters

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.
RecordId	Guid	Unique identifier of a record
Form8453EMPPdf	string	Pulls Form 8453 Pdf success and error status messages
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.

Request JSON

{
 "RecordId": "eed7cf65-088e-4eba-800a-dcd54c0d05bb",
 "Form8453EMPPdf":"QEA="
}

1
2
3
4

Response JSON

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "RecordId": "eed7cf65-088e-4eba-800a-dcd54c0d05bb",
 "Form8453EMPPdf": "Form 8453-EMP is uploaded to the return (record id: eed7cf65-088e-4eba-800a-dcd54c0d05bb)",
 "Errors": null
}

1
2
3
4
5
6
7
8

# Validate

Runs business and data validation checks for the 943 forms already created in API. You must use the Submission ID of the return to Validate.

GET Form943/Validate

Request Parameters

Field	Type	Description
SubmissionId	guid	Unique identifier of a submission
RecordIds	guid[]	`Optional` Unique identifier of a record

Response Parameters

Field	Type	Description
StatusCode	number	Returns the HTTP status codes like 200,300 etc.
StatusName	string	Name of the status code.
StatusMessage	string	Detailed status message.
SubmissionId	Guid	Unique identifier of a submission.
Form943Records	object	Pulls the Form 943 records with Success and Error statuses.
SuccessRecords	object[]	It will show the detailed information about the success status of Form 943 Records.
Sequence	string	A unique number given by an inbound application to identify failed records.
RecordId	Guid	Unique identifier of a record.
RecordStatus	string	Returns the status of the records.
CreatedTs	string	Date and time of return created.
UpdatedTs	string	Date and time of return updated.
ErrorRecords	object[]	It will show the detailed information about the error status of Form 943 Records.
RecordId	Guid	Unique identifier of a record.
Sequence	string	A unique number given by an inbound application to identify failed records.
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.
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.

Request JSON

Form943/Validate?SubmissionId=f2fee2f8-74bf-4e1d-9239-399e76929475&RecordIds=ed6bc24b-189d-419b-9224-2dd2bf3b7467

Response JSON

{
 "StatusCode": 200,
 "StatusName": "Ok",
 "StatusMessage": "Successful API call",
 "SubmissionId": "f2fee2f8-74bf-4e1d-9239-399e76929475",
 "Form943Records": {
   "SuccessRecords": [
     {
       "Sequence": "",
       "RecordId": "ed6bc24b-189d-419b-9224-2dd2bf3b7467",
       "RecordStatus": "Created",
       "CreatedTs": "2020-02-02 03:06:07 -04:00",
       "UpdatedTs": "2020-02-02 03:46:54 -04:00"
     }
   ],
   "ErrorRecords": []
 },
 "Errors": null
}

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# ValidateForm

Runs business and data validation checks for 943 forms.

POST Form943/ValidateForm

Request Parameters

Field	Type	Description
Form943Records	object[]	Object to create 943s
Sequence	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. Allowed values: "FORM943"
TaxYr	string	The Tax year for which Form 943 needs to be filed.
Business	object	Business Details
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
Email	string	Email address of the Business Size Range: ..40
ContactNm	string	Name of the person who can be contacted by the IRS Size Range: ..27
Phone	string	Contact number of the business with area code Size Range: 10
PhoneExtn	string	`Optional` Extension of the business phone number Size Range: ..5
Fax	string	`Optional` Fax number of the Business Size Range: 10
BusinessType	string	Type of business. Optional for W-2/1099 and mandatory for 94X series Size Range: ..4 Allowed values: "ESTE", "PART", "CORP", "EORG", "SPRO"
SigningAuthority	object	Details of the person who is authorized to sign the return
Name	string	Name of the signing authority. Size Range: ..35
Phone	string	Phone number of the signing authority. Size Range: 10
BusinessMemberType	string	Business title of the signing authority Size Range: 5..29 Allowed values: "CORPORATESECRETARY", "SECRETARYTREASURER", "PARTNER", "GENERALPARTNER", "LIMITEDPARTNER", "LLCMEMBER", "MANAGINGMEMBER", "MANAGER", "TAXMATTERPARTNER", "PRESIDENT", "VICEPRESIDENT", "CORPORATETREASURER", "TREASURER", "ASSISTANTTREASURER", "CHIEFACCOUNTINGOFFICER", "CHIEFEXECUTIVEOFFICER", "CHIEFFINANCIALOFFICER", "TAXOFFICER", "CHIEFOPERATINGOFFICER", "CORPORATEOFFICER", "EXECUTIVEDIRECTOR", "DIRECTOR", "CHAIRMAN", "EXECUTIVEADMINISTRATOR", "RECEIVER", "PASTOR", "ASSISTANTTORELIGIOUSLEADER", "REVEREND", "PRIEST", "MINISTER", "RABBI", "LEADEROFRELIGIOUSORGANIZATION", "SECRETARY", "DIRECTOROFTAXATION", "DIRECTOROFPERSONNEL", "ADMINISTRATOR", "EXECUTOR", "TRUSTEE", "FIDUCIARY", "OWNER", "SOLEPROPRIETOR", "MEMBER", "SOLEMEMBER"
KindOfEmployer	string	Identifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series. Allowed values: "FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"
KindOfPayer	string	Kind Of Payer based on the Employer's Federal Tax Return. Allowed values: "REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"
IsBusinessTerminated	Boolean	When true, identifies the business as terminated.
IsForeign	Boolean	When true, identifies the business address with a foreign address.
USAddress	object	if IsForeign is false, pass US address of the business
Address1	string	Employer/Payer's US address (street address or post office box of that locality) Size Range: ..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 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
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 Size Range: 2 Allowed values: "US", "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
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
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 Buiness 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 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
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 Size Range: 2 Allowed values: "US", "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
ReturnData	object	Identifies the Form 943 data
Form943	object	Form 943, Employer’s QUARTERLY Federal Tax Return
PriorAddressInd	Boolean	When true, If address is different from prior return.
EmployeeCnt	number	Gets the number of Employees who has received wages, tips, or other compensation for the pay period. Line 1
SocialSecurityTaxCashWagesAmt_Col1	number	Gets the taxable social security wages amount. Line 2 Size Range: 0-99999999999999.99
SocialSecurityTaxAmt	number	Gets the taxable social security tips amount. Line 3 Size Range: 0-99999999999999.99
MedicareTaxCashWagesAmt	number	Gets the taxable medicare wages and tips amount. Line 4 Size Range: 0-99999999999999.99
MedicareTaxWithheldAmt	number	Gets the taxable medicare withheld amount. Line 5 Size Range: 0-99999999999999.99
TotMedcrTaxCashWagesAddnlWhAmt	number	Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Line 6 Size Range: 0-99999999999999.99
AddnlMedicareTaxWithholdingAmt	number	Gets additional Medicare Tax withholding amount. Line 7 Size Range: 0-99999999999999.99
FederalIncomeTaxWithheldAmt	number	Gets the tax on Federal Income Tax withheld. Line 8 Size Range: 0-99999999999999.99
TotalTaxBeforeAdjustmentAmt	number	Gets the total taxes beofre adjustments by adding lines 3, 5,7 and 8. Line 9 Size Range: 0-99999999999999.99
CurrentYearAdjustmentAmt	number	Gets the tax on current year's adjustments. Line 10 Size Range: 0-99999999999999.99
TotalTaxAfterAdjustmentAmt	number	Gets the Total taxes Security after adding adjustments by line 9 adjusted by line 10. Line 11 Size Range: 0-99999999999999.99
PayrollTaxCreditAmt	number	Gets the tax for qualified small business payroll tax credits.line 12 Size Range: 0-99999999999999.99
TotalTaxAmt	number	Gets the Total taxes after adjustments and credits by subtracting line 12 from line 11.Line 13. Size Range: -99999999999999.99-99999999999999.99
TotalTaxDepositAmt	number	Gets the amount of total tax deposits including overpayment applied from prior year and Form 943-x. Line 14. Size Range: -99999999999999.99-99999999999999.99
BalanceDueAmt	number	Gets the amount of difference between line 13 and line 14, if line 13 is greater than line 14. Line 15. Size Range: -99999999999999.99-99999999999999.99
OverpaidAmt	number	Gets the amount difference between line 14 and line 13, if line 14 is greater than line 13. Line 16. Size Range: -99999999999999.99-99999999999999.99
IsOverPayment	Boolean	When true, identifies the Line 12 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, 1065, 1120, 1120-F, or 1120S. Part 1 Column (b)
IncomeTaxReturnFiledDate	string	Gets the income tax return filing date shown in column (b). Part 1 Column (c)
Form6765EIN	string	Gets the EIN used on Form 6765 if the EIN used on Form 8974 doesn't match with the EIN on Form 6765. Part 1 Column (d) Size Range: 9
Form6765Line44Amt	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 943, 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 943, line 5b, column 2; or Form 944, line 4b, column 2. Part 2 Line 9. Size Range: 0-99999999999999.99
Line10	number	Gets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10. Size Range: 0-99999999999999.99
Line11	number	Gets the amount of line 10 multiplied by 50% (0.50) on line 11. If you’re a third-party payer of sick pay or you received a Section 3121(q) Notice and Demand, check the applicable box on line 11. Size Range: 0-99999999999999.99
PayerIndicatorType	string	Identifies if you are a Third-party payer of sick pay or received a Section 3121(q) Notice and Demand
Line12	number	Gets the credit amount smaller of line 7 or line 11. Also, this amount entered on Form 943 (943-PR or 943-SS), line 11; Form 943 (943-PR), line 12; or Form 944 (944(SP)), line 8 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 943-X, 943-X(PR), 944-X, or 944-X(SP) filed in the current quarter. Line 13 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"
FilerType	string	Type of Form 943 filer
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 (Checking or Saving) of EFW payment
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 16, Option 2. Monthly Schedule Depositor
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.
TaxLiabilityTotalAmt	number	Total tax liability amount. Size Range: 0-99999999999999.99
SemiWeeklyDepositor	object	Line 16, Option 3. SemiWeekly Depositor
Form943AJanMonthAmt	object[]	Tax Liability for January in Form 943 A.
Day	string	Tax Lability 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	. Size Range: 0-99999999999999.99
Form943AJanMonthTotAmt	object[]	Total Tax Liability for January in Form 943 A.
Form943AFebMonthAmt	object[]	Tax Liability for February in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AFebMonthTotAmt	object[]	Total Tax Liability for February in Form 943 A.
Form943AMarMonthAmt	object[]	Tax Liability for March in Form 943 A.
Day	string	Tax Lability 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	. Size Range: 0-99999999999999.99
Form943AJMarMonthTotAmt	object[]	Total Tax Liability for March in Form 943 A.
Form943AAprMonthAmt	object[]	Tax Liability for April in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AAprMonthTotAmt	object[]	Total Tax Liability for April in Form 943 A.
Form943AMayMonthAmt	object[]	Tax Liability for May in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AMayMonthTotAmt	object[]	Total Tax Liability for May in Form 943 A.
Form943AJunMonthAmt	object[]	Tax Liability for Jume in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AJunMonthTotAmt	object[]	Total Tax Liability for June in Form 943 A.
Form943AJulMonthAmt	object[]	Tax Liability for July in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AJulMonthTotAmt	object[]	Total Tax Liability for July in Form 943 A.
Form943AAugMonthAmt	object[]	Tax Liability for August in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AAugMonthTotAmt	object[]	Total Tax Liability for August in Form 943 A.
Form943ASepMonthAmt	object[]	Tax Liability for September in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943ASepMonthTotAmt	object[]	Total Tax Liability for September in Form 943 A.
Form943AOctMonthAmt	object[]	Tax Liability for October in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943AOctMonthTotAmt	object[]	Total Tax Liability for October in Form 943 A.
Form943ANovMonthAmt	object[]	Tax Liability for November in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943ANovMonthTotAmt	object[]	Total Tax Liability for November in Form 943 A.
Form943ADecMonthAmt	object[]	Tax Liability for December in Form 943 A.
Amt	number	. Size Range: 0-99999999999999.99
Form943ADecMonthTotAmt	object[]	Total Tax Liability for December in Form 943 A.

Response Parameters

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.

Request JSON

         {
 "Form943Records": [
   {
     "Sequence": "01",
     "ReturnHeader": {
       "ReturnType": "Form943",
       "TaxYr": "2019",
       "Business": {
         "BusinessId": null,
         "BusinessNm": "Rhonda Agri LLC",
         "TradeNm": null,
         "IsEIN": true,
         "EINorSSN": "12-3456789",
         "Email": "rhondas.r@agrillc.com",
         "ContactNm": "Rhonda Charles",
         "Phone": "1234567890",
         "PhoneExtn": null,
         "Fax": "1234567890",
         "BusinessType": "CORP",
         "SigningAuthority": {
           "Name": "Rhonda Charles",
           "Phone": "1234567890",
           "BusinessMemberType": "PRESIDENT"
         },
         "KindOfEmployer": null,
         "KindOfPayer": null,
         "IsBusinessTerminated": false,
         "IsForeign": false,
         "USAddress": {
           "Address1": "123 Kinsley Rd",
           "Address2": "Main St",
           "City": "Seattle",
           "State": "WA",
           "ZipCd": "98944"
         },
         "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": "1234567899"
         },
         "ReportingAgentPIN": {
           "PIN": null
         },
         "Form8453EMP": null
       },
       "BusinessStatusDetails":{
         "IsBusinessClosed": false
		  }
     },
     "ReturnData": {
       "Form943": {
         "EmployeeCnt": 5,
         "SocialSecurityTaxCashWagesAmt": 100.0,
         "SocialSecurityTaxAmt": 100.0,
         "MedicareTaxCashWagesAmt": 100.0,
         "MedicareTaxWithheldAmt": 100.0,
         "TotMedcrTaxCashWagesAddnlWhAmt": 100.0,
         "AddnlMedicareTaxWithholdingAmt": 100.0,
         "FederalIncomeTaxWithheldAmt": 100.0,
         "TotalTaxBeforeAdjustmentAmt": 100.0,
         "CurrentYearAdjustmentAmt": 100.0,
         "TotalTaxAfterAdjustmentAmt": 100.0,
         "PayrollTaxCreditAmt": 0.0,
         "Form8974": {
           "Form8974IncomeTaxDetails": [
             {
               "IncomeTaxPeriodEndDate": null,
               "IncomeTaxReturnFiledForm": null,
               "IncomeTaxReturnFiledDate": null,
               "Form6765EIN": null,
               "Form6765Line44Amt": 0.0,
               "PreviousPeriodRemainingCreditAmt": 0.0,
               "RemainingCredit": 0.0
             },
             {
               "IncomeTaxPeriodEndDate": null,
               "IncomeTaxReturnFiledForm": null,
               "IncomeTaxReturnFiledDate": null,
               "Form6765EIN": null,
               "Form6765Line44Amt": 0.0,
               "PreviousPeriodRemainingCreditAmt": 0.0,
               "RemainingCredit": 0.0
             },
             {
               "IncomeTaxPeriodEndDate": null,
               "IncomeTaxReturnFiledForm": null,
               "IncomeTaxReturnFiledDate": null,
               "Form6765EIN": null,
               "Form6765Line44Amt": 0.0,
               "PreviousPeriodRemainingCreditAmt": 0.0,
               "RemainingCredit": 0.0
             },
             {
               "IncomeTaxPeriodEndDate": null,
               "IncomeTaxReturnFiledForm": null,
               "IncomeTaxReturnFiledDate": null,
               "Form6765EIN": null,
               "Form6765Line44Amt": 0.0,
               "PreviousPeriodRemainingCreditAmt": 0.0,
               "RemainingCredit": 0.0
             },
             {
               "IncomeTaxPeriodEndDate": null,
               "IncomeTaxReturnFiledForm": null,
               "IncomeTaxReturnFiledDate": null,
               "Form6765EIN": null,
               "Form6765Line44Amt": 0.0,
               "PreviousPeriodRemainingCreditAmt": 0.0,
               "RemainingCredit": 0.0
             }
           ],
           "Line7": null,
           "Line8": null,
           "Line9": null,
           "Line10": null,
           "Line11": null,
           "PayerIndicatorType": null,
           "Line12": null
         },
         "TotalTaxAmt": 2000.0,
         "TotalTaxDepositAmt": 20000.0,
         "BalanceDueAmt": 100.0,
         "OverpaidAmt": 0.0,
         "OverPaymentRecoveryType": null
       },
       "IRSPaymentType": null,
       "IRSPayment": {
         "BankRoutingNum": null,
         "AccountType": null,
         "BankAccountNum": null,
         "Phone": null
       },
       "FinalPayRoll": {
         "PersonNm": 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
         }
       },
       "DepositScheduleType": {
         "DepositorType": "SEMIWEEKLY",
         "MonthlyDepositor": {
           "JanTaxLiability": 0.0,
           "FebTaxLiability": 0.0,
           "MarTaxLiability": 0.0,
           "AprTaxLiability": 0.0,
           "MayTaxLiability": 0.0,
           "JunTaxLiability": 0.0,
           "JulTaxLiability": 0.0,
           "AugTaxLiability": 0.0,
           "SepTaxLiability": 0.0,
           "OctTaxLiability": 0.0,
           "NovTaxLiability": 0.0,
           "DecTaxLiability": 0.0
         },
         "SemiWeeklyDepositor": {
           "Form943AJanMonthAmt": [
             {
               "Day": 9,
               "Amt": 100.0
             },
             {
               "Day": 0,
               "Amt": 0.0
             },
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AFebMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             },
             {
               "Day": 0,
               "Amt": 0.0
             },
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AMarMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AAprMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AMayMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AJunMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AJulMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AAugMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943ASepMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943AOctMonthAmt": [
             {
               "Day": 0,
               "Amt": 0.0
             }
           ],
           "Form943ANovMonthAmt": [
             {
               "Day": 3,
               "Amt": 2000.0
             }
           ],
           "Form943ADecMonthAmt": [
             {
               "Day": 2,
               "Amt": 1000.0
             }
           ]
         },
         "TotalTaxLiabilityWholeYearAmt": 3000.0
       }
     }
   }
    ]
}

Response JSON

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

1
2
3
4
5
6

← Form941SCHR FormW2 →