# Form941
# Create
Creates Form 941 returns with a unique Submission Id which is further used for all other methods referencing these 941s.
POST Form941/Create
1
Request Body
| Field | Type | Description |
|---|---|---|
| Form941Records | object[] | Object to create 941s |
| SequenceId | string | A unique number given by an inbound application to identify failed records. Size Range: ..10 |
| ReturnHeader | object | Identifies the supporting details of Form 941. |
| ReturnType | string | Type of the return to be filed. Enter values like FORM941, FORM941PR, FORM941SS. Allowed values: "FORM941", "FORM941PR", "FORM941SS" |
| TaxYr | string | The Tax year for which Form 941 needs to be filed. Allowed values: "2022" |
| Qtr | string | The Quarter for which Form 941 needs to be filed. Allowed values: "Q1" |
| Business | object | Business Details |
| BusinessId | Guid | Optional Business Identifier (Autogenerated). |
| BusinessNm | string | Name of the business Size Range: ..75 |
| TradeNm | string | Optional Name under which the business operatesSize 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 |
| 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 numberSize Range: ..5 |
| Fax | string | Optional Fax number of the BusinessSize 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 apartmentSize 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 apartmentSize 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 941 |
| SignatureType | string | Type of signature used to sign Form 941 Allowed values: "ONLINE_SIGN_PIN", "FORM_8453_EMP", "REPORTING_AGENT" |
| OnlineSignaturePIN | object | A 10-digit signature PIN to become an IRS authorized signer. |
| PIN | string | Sign using a 10 digit PIN received from the IRS. Size Range: 10 |
| ReportingAgentPIN | object | A 5-digit number assigned by the IRS |
| PIN | string | Sign using a 5 digit PIN received from the IRS. Size Range: 5 |
| BusinessStatusDetails | object | Identifies the status of the Business |
| IsBusinessClosed | Boolean | When true, identifies the business as terminated or stopped paying wages |
| BusinessClosedDetails | object | Identifies the Record Keeper details and date on which the 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 apartmentSize 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 apartmentSize 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 | When true, identifies the business as transferred. |
| BusinessTransferredDetails | object | Type of Transfer and Record Keeper details |
| Name | string | Name of the Record Keeper |
| BusinessChangeType | string | Type of Transfer. Allowed values: "SOLD", "TRANSFERRED" |
| DateOfChange | DateTime | Date of Sale / Transfer |
| NewBusinessType | string | New Business Type of the transferred business Allowed values: "ESTE", "PART", "CORP", "EORG", "SPRO" |
| NewBusinessName | string | New Business Name of the transferred business |
| IsForeign | Boolean | When true, identifies if the business has a foreign address. |
| USAddress | object | if IsForeign is false, pass US address of the business |
| Address1 | string | Employer/Payer's US address (street address or post office box of that locality) Size Range: ..35 |
| Address2 | string | Optional Employer/Payer's suite or apartmentSize Range: ..35 |
| City | string | Employer/Payer's city Size Range: ..27 |
| State | string | State code of the employer/payer. Refer Static values. Size Range: 2 Allowed values: "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" |
| ZipCd | string | Employer/Payer's zip code |
| 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 apartmentSize Range: ..35 |
| City | string | Employer/Payer's city Size Range: ..27 |
| ProvinceOrStateNm | string | Employer/Payer's province or state name. Size Range: ..30 |
| Country | string | Employer/Payer country code. Refer Static values. 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 |
| IsSeasonalEmployer | Boolean | When true, identifies if the return is for a seasonal employer and the employer don't have to file a return for every quarter of the year. |
| ReturnData | object | Identifies the Form 941 data |
| Form941 | object | Form 941, Employer's QUARTERLY Federal Tax Return |
| EmployeeCnt | number | Gets the number of Employees who has received wages, tips, or other compensation for the pay period including Mar. 12 (Quarter 1), June 12 (Quarter 2), Sept. 12 (Quarter 3), or Dec. 12 (Quarter 4). |
| WagesAmt | number | Gets the wages, tips, and other compensation for the Quarter Size Range: 0-99999999999999.99 |
| FedIncomeTaxWHAmt | number | Gets the federal income tax withheld from wages, tips, and other compensation Size Range: 0-99999999999999.99 |
| WagesNotSubjToSSMedcrTaxInd | Boolean | When true, identifies if no wages, tips, and other compensation on line 2 are subject to social security or Medicare tax. |
| SocialSecurityTaxCashWagesAmt_Col1 | number | Gets the taxable social security wages amount. Line 5a Column 1 Size Range: 0-99999999999999.99 |
| QualSickLeaveWagesAmt_Col1 | number | Qualified Sick Leave wages under SS wage base column 1. Size Range: 0-99999999999999.99 |
| QualFamilyLeaveWagesAmt_Col1 | number | Qualified Family Leave wages under SS wage base column 1. Size Range: 0-99999999999999.99 |
| TaxableSocSecTipsAmt_Col1 | number | Gets the taxable social security tips amount. Line 5b Column 1. Size Range: 0-99999999999999.99 |
| TaxableMedicareWagesTipsAmt_Col1 | number | Gets the taxable medicare wages and tips amount. Line 5c Column 1. Size Range: 0-99999999999999.99 |
| TxblWageTipsSubjAddnlMedcrAmt_Col1 | number | Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Line 5d Column 1. Size Range: 0-99999999999999.99 |
| SocialSecurityTaxAmt_Col2 | number | Gets the tax on Social Security Wages. Line 5a Column 2. Size Range: 0-99999999999999.99 |
| TaxOnQualSickLeaveWagesAmt_Col2 | number | Qualified Sick Leave wages under SS wage base column 2. Size Range: 0-99999999999999.99 |
| TaxOnQualFamilyLeaveWagesAmt_Col2 | number | Qualified Family Leave wages under SS wage base column 2. Size Range: 0-99999999999999.99 |
| TaxOnSocialSecurityTipsAmt_Col2 | number | Gets the tax on Social Security Tips. Line 5b Column 2. Size Range: 0-99999999999999.99 |
| TaxOnMedicareWagesTipsAmt_Col2 | number | Gets the tax on Taxable Medicare Wages and Tips subject to Medicare Amount. Line 5c Column 2. Size Range: 0-99999999999999.99 |
| TaxOnWageTipsSubjAddnlMedcrAmt_Col2 | number | Gets the tax on Taxable Wages and Tips subject to Additional Medicare Tax withholding amount. Line 5d Column 2. Size Range: 0-99999999999999.99 |
| TotSSMdcrTaxAmt | number | Gets the Total Social Security and Medicare Tax Amount. Line 5e. Size Range: 0-99999999999999.99 |
| TaxOnUnreportedTips3121qAmt | number | Gets the tax due from Section 3121(q) Notice and Demand on line 5f. Size Range: 0-99999999999999.99 |
| TotalTaxBeforeAdjustmentAmt | number | Gets the Total taxes before adjustments by adding the amounts on lines 3, 5e, and 5f on Line 6. Size Range: -99999999999999.99-99999999999999.99 |
| CurrentQtrFractionsCentsAmt | number | Gets the amount of current quarter's adjustment for fractions of cents. Line 7. Size Range: -99999999999999.99-99999999999999.99 |
| CurrentQuarterSickPaymentAmt | number | Gets the amount of current quarter's adjustment for sick pay. Line 8. Size Range: -99999999999999.99-99999999999999.99 |
| CurrQtrTipGrpTermLifeInsAdjAmt | number | Gets the amount of current quarter's adjustments for tips and group-term life insurance. Line 9. Size Range: -99999999999999.99-99999999999999.99 |
| TotalTaxAfterAdjustmentAmt | number | Gets the amount of Total taxes after adjustments by adding amount in line 6 through line 9. Line 10. Size Range: -99999999999999.99-99999999999999.99 |
| PayrollTaxCreditAmt | number | Gets the amount of qualified small business payroll tax credit for increasing research activities. Line 11. Size Range: 0-99999999999999.99 |
| IsPayrollTaxCredit | Boolean | When true, identifies the Line 11 is greater than zero to determine the amount of qualified small business payroll tax credit for increasing research activities that a business can claim on Form 941. |
| Form8974 | object | Information of Form 8974 |
| Form8974IncomeTaxDetails | object[] | Collection of Income Tax details |
| IncomeTaxPeriodEndDate | string | Gets the ending date of income tax period in Part 1 Column (a). |
| IncomeTaxReturnFiledForm | string | Gets the Income tax return filed to elected a qualified small business payroll tax credit on Form 6765. Form 6765 can be attached to Form 1040, 1065, 1120, 1120-F, or 1120S. Part 1 Column (b) |
| IncomeTaxReturnFiledDate | string | Gets the income tax return filing date shown in column (b). Part 1 Column (c) |
| Form6765EIN | string | Gets the EIN used on Form 6765 if the EIN used on Form 8974 doesn't match with the EIN on Form 6765. Part 1 Column (d) Size Range: 9 |
| Form6765Line44Amt | number | Gets the amount from Form 6765, line 44 or the amount allocated to your EIN if applicable. Part 1 Column (e) Size Range: 0-99999999999999.99 |
| PreviousPeriodRemainingCreditAmt | number | Gets the amount of credit from column (e) taken on a previous period(s). Part 1 Column (f) Size Range: 0-99999999999999.99 |
| RemainingCredit | number | Gets the total amount of remaining credit by subtracting column (f) from column (e). Part 1 Column (g). Size Range: 0-99999999999999.99 |
| Line7 | number | Gets the total amount from Part 1, line 6(g). Part 2 Line 7. Size Range: 0-99999999999999.99 |
| Line8 | number | Gets the total amount of social security tax on wages from Form 941, line 5a, column 2; Form 943, line 3; or Form 944, line 4a, column 2. Part 2 Line 8. Size Range: 0-99999999999999.99 |
| Line9 | number | Gets the total amount of social security tax on tips from Form 941, line 5b, column 2; or Form 944, line 4b, column 2. Part 2 Line 9. Size Range: 0-99999999999999.99 |
| Line10 | number | Gets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10. Size Range: 0-99999999999999.99 |
| Line11 | number | Gets the amount of line 10 multiplied by 50% (0.50) on line 11. If you're a third-party payer of sick pay or you received a Section 3121(q) Notice and Demand, check the applicable box on line 11. Size Range: 0-99999999999999.99 |
| PayerIndicatorType | string | Identifies if you are a Third-party payer of sick pay or received a Section 3121(q) Notice and Demand Allowed values: "THIRDPARTYSICKPAYIND", "SECTION3121QIND" |
| Line12 | number | Gets the credit amount smaller of line 7 or line 11. Also, this amount entered on Form 941 (941-PR or 941-SS), line 11; Form 943 (943-PR), line 12; or Form 944 (944(SP)), line 8 Size Range: 0-99999999999999.99 |
| NonRfdCrQualSickAndFamilyWagesB4_Apr1_2021 | number | Nonrefundable portion of credit for qualified sick and family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| NonRfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Nonrefundable portion of credit for qualified sick and family leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99 |
| NonRfdCobraPremAsstCr | number | Nonrefundable portion of COBRA premium assistance credit. Size Range: 0-99999999999999.99 |
| NumOfIndivCobraPremAsst | int | Nonrefundable portion of COBRA premium assistance credit. |
| TotlNonRfdCrAmt | number | Total nonrefundable credits. Size Range: 0-99999999999999.99 |
| TotTaxAfterAdjustmentAndNonRfdCr | number | Total taxes after adjustments and nonrefundable credits. Size Range: 0-99999999999999.99 |
| TotTaxDepositAmt | number | Gets the total deposits for the quarter, including overpayment amount applied from a prior quarter and overpayments applied by filing Form 941-X, 941-X(PR), 944-X, or 944-X(SP) filed in the current quarter. Line 13. Size Range: 0-99999999999999.99 |
| RfdCrQualSickAndFamilyWagesB4_Apr1_2021 | number | Refundable portion of credit for qualified sick and family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| RfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Refundable portion of credit for qualified sick and family leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99 |
| RfdCobraPremAsstCr | number | Refundable portion of COBRA premium assistance credit. Size Range: 0-99999999999999.99 |
| TotDepositAndRfdCrAmt | number | Total deposits and refundable credits. Size Range: 0-99999999999999.99 |
| BalanceDueAmt | number | Gets the difference amount of the balance due if line 12 is more than line 13. Line 14. Size Range: 0-99999999999999.99 |
| OverpaidAmt | number | Gets the difference overpayment amount if line 13 is more than line 12. Line 15. Size Range: 0-99999999999999.99 |
| OverPaymentRecoveryType | string | Gets the overpayment recovery type, whether to have the IRS refund the excess amount or apply it to next return. Check only one box on line 15. Allowed values: "REFUND", "APPLYTORETURN" |
| QualHealthPlanExpToSickLeaveWagesB4_Apr1_2021 | number | Qualified health plan expenses allocable to qualified sick leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| QualHealthPlanExpToFamilyLeaveWagesB4_Apr1_2021 | number | Qualified health plan expenses allocable to qualified family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| QualSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified sick leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99 |
| QualHealthPlanExpToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified health plan expenses allocable to qualified sick leave wages reported on line 23. Size Range: 0-99999999999999.99 |
| CBAToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Amounts under certain collectively bargained agreements allocable to qualified sick leave wages reported on line 23. Size Range: 0-99999999999999.99 |
| QualFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified family leave wages for leave taken after March 31, 2021 and before October 1, 2021. Size Range: 0-99999999999999.99 |
| QualHealthPlanExpToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified health plan expenses allocable to qualified family leave wages reported on line 26. Size Range: 0-99999999999999.99 |
| CBAToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Amounts under certain collectively bargained agreements allocable to qualified family leave wages reported on line 26. Size Range: 0-99999999999999.99 |
| IRSPaymentType | string | EFW, EFTPS, Check or Money Order Allowed values: "EFW", "EFTPS", "CHECK_OR_MO" |
| IRSPayment | object | Identifies the details of Electronic Funds Withdrawal (EFW) if paying the balance due along with the return |
| BankRoutingNum | string | Bank Routing Number of EFW payment Size Range: 9 |
| AccountType | string | Account Type of EFW payment Allowed values: "CHECKING", "SAVING" |
| BankAccountNum | string | Bank Account Number of EFW payment Size Range: ..17 |
| Phone | string | Phone of EFW payment Size Range: 10 |
| DepositScheduleType | object | Identifies the Employer's deposit schedule and tax liability for the quarter |
| DepositorType | string | Type of Deposit Schedule. Values like Monthly or Semi Weekly Allowed values: "MINTAXLIABILITY", "MONTHLY", "SEMIWEEKLY" |
| MonthlyDepositor | object | Line 16, Option 2. Monthly Schedule Depositor |
| TaxLiabilityMonth1 | number | Tax Liability for Month 1 of the filing quarter. |
| TaxLiabilityMonth2 | number | Tax Liability for Month 2 of the filing quarter. |
| TaxLiabilityMonth3 | number | Tax Liability for Month 3 of the filing quarter. |
| SemiWeeklyDepositor | object | Line 16, Option 3. SemiWeekly Depositor |
| ScheduleBMonth1Amt | object[] | Tax Liability for Month 1 of the filing quarter in Form Schedule B. |
| Day | string | Tax Lability Day of the month. Allowed values: "Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28", "Day29", "Day30", "Day31" |
| Amt | number | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| ScheduleBMonth2Amt | object[] | Tax Liability for Month 2 of the filing quarter in Form Schedule B. |
| Day | string | Tax Lability Day of the month. Allowed values: "Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28" |
| Amt | number | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| ScheduleBMonth3Amt | object[] | Tax Liability for Month 3 of the filing quarter in Form Schedule B. |
| Day | string | Tax Lability Day of the month. Allowed values: "Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28", "Day29", "Day30", "Day31" |
| Amt | number | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| TotalQuarterTaxLiabilityAmt | number | Total tax liability amount for the quarter. Size Range: 0-99999999999999.99 |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| SubmissionId | Guid | Unique identifier of a submission. |
| Form941Records | object | Pulls the Form 941 records with Success and Error statuses. |
| SuccessRecords | object[] | It will show the detailed information about the success status of Form 941 Records. |
| SequenceId | 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 941 Records. |
| RecordId | Guid | Unique identifier of a record. |
| SequenceId | string | A unique number given by an inbound application to identify failed records. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error Id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
{
"Form941Records": [
{
"SequenceId": "001",
"ReturnHeader": {
"ReturnType": "FORM941",
"TaxYr": "2022",
"Qtr": "Q1",
"Business": {
"BusinessId": null,
"BusinessNm": "Eastman Bridge Company",
"TradeNm": null,
"IsEIN": true,
"EINorSSN": "002352234",
"Email": "alicejohn@gmail.com",
"ContactNm": "Alice John",
"Phone": "1654798798",
"PhoneExtn": null,
"Fax": "5649879878",
"BusinessType": "CORP",
"SigningAuthority": {
"Name": "Tina Charles",
"Phone": "7498798798",
"BusinessMemberType": "PRESIDENT"
},
"KindOfEmployer": null,
"KindOfPayer": null,
"IsBusinessTerminated": false,
"IsForeign": false,
"USAddress": {
"Address1": "1751 Kinsey Rd",
"Address2": "Main St",
"City": "Dothan",
"State": "AL",
"ZipCd": "36303"
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
}
},
"IsThirdPartyDesignee": false,
"ThirdPartyDesignee": {
"Name": null,
"Phone": null,
"PIN": null
},
"SignatureDetails": {
"SignatureType": "ONLINE_SIGN_PIN",
"OnlineSignaturePIN": {
"PIN": "4564564555"
},
"ReportingAgentPIN": {
"PIN": null
},
"Form8453EMP": null
},
"BusinessStatusDetails": {
"IsBusinessClosed": false,
"BusinessClosedDetails": {
"Name": null,
"FinalDateWagesPaid": null,
"IsForeign": false,
"USAddress": {
"Address1": null,
"Address2": null,
"City": null,
"State": null,
"ZipCd": null
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
}
},
"IsBusinessTransferred": false,
"BusinessTransferredDetails": {
"Name": null,
"BusinessChangeType": null,
"DateOfChange": null,
"NewBusinessType": null,
"NewBusinessName": null,
"IsForeign": false,
"USAddress": {
"Address1": null,
"Address2": null,
"City": null,
"State": null,
"ZipCd": null
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
}
},
"IsSeasonalEmployer": false
}
},
"ReturnData": {
"Form941": {
"EmployeeCnt": 200,
"WagesAmt": 40000,
"FedIncomeTaxWHAmt": 25000,
"WagesNotSubjToSSMedcrTaxInd": false,
"SocialSecurityTaxCashWagesAmt_Col1": 400,
"QualSickLeaveWagesAmt_Col1": 300,
"QualFamilyLeaveWagesAmt_Col1": 200,
"TaxableSocSecTipsAmt_Col1": 200,
"TaxableMedicareWagesTipsAmt_Col1": 100,
"TxblWageTipsSubjAddnlMedcrAmt_Col1": 150,
"SocialSecurityTaxAmt_Col2": 49.6,
"TaxOnQualSickLeaveWagesAmt_Col2": 18.6,
"TaxOnQualFamilyLeaveWagesAmt_Col2": 12.4,
"TaxOnSocialSecurityTipsAmt_Col2": 24.8,
"TaxOnMedicareWagesTipsAmt_Col2": 2.9,
"TaxOnWageTipsSubjAddnlMedcrAmt_Col2": 1.35,
"TotSSMdcrTaxAmt": 109.65,
"TaxOnUnreportedTips3121qAmt": 500,
"TotalTaxBeforeAdjustmentAmt": 25609.65,
"CurrentQtrFractionsCentsAmt": -300,
"CurrentQuarterSickPaymentAmt": -200,
"CurrQtrTipGrpTermLifeInsAdjAmt": -100,
"TotalTaxAfterAdjustmentAmt": 25009.65,
"PayrollTaxCreditAmt": 37.2,
"IsPayrollTaxCredit": true,
"Form8974": {
"Form8974IncomeTaxDetails": [
{
"IncomeTaxPeriodEndDate": "07-07-2020",
"IncomeTaxReturnFiledForm": "FORM1065",
"IncomeTaxReturnFiledDate": "07-07-2020",
"Form6765EIN": "001287038",
"Form6765Line44Amt": 100,
"PreviousPeriodRemainingCreditAmt": 50,
"RemainingCredit": 50
}
],
"Line7": 50,
"Line8": 49.6,
"Line9": 24.8,
"Line10": 74.4,
"Line11": 37.2,
"PayerIndicatorType": "SECTION3121QIND",
"Line12": 37.2
},
"NonRfdCrQualSickAndFamilyWagesB4_Apr1_2021": 75,
"NonRfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021": 515,
"NonRfdCobraPremAsstCr": 10,
"NumOfIndivCobraPremAsst": 40,
"TotlNonRfdCrAmt": 637.2,
"TotTaxAfterAdjustmentAndNonRfdCr": 24372.45,
"TotTaxDepositAmt": 400,
"RfdCrQualSickAndFamilyWagesB4_Apr1_2021": 8,
"RfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021": 20,
"RfdCobraPremAsstCr": 20,
"TotDepositAndRfdCrAmt": 448,
"BalanceDueAmt": 23924.45,
"OverpaidAmt": 0,
"OverPaymentRecoveryType": null,
"QualHealthPlanExpToSickLeaveWagesB4_Apr1_2021": 400.25,
"QualHealthPlanExpToFamilyLeaveWagesB4_Apr1_2021": 500.25,
"QualSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 800.25,
"QualHealthPlanExpToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 0,
"CBAToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 500.25,
"QualFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 600.25,
"QualHealthPlanExpToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 400.25,
"CBAToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 400.25
},
"IRSPaymentType": "EFTPS",
"IRSPayment": {
"BankRoutingNum": null,
"AccountType": null,
"BankAccountNum": null,
"Phone": null
},
"DepositScheduleType": {
"DepositorType": "MONTHLY",
"MonthlyDepositor": {
"TaxLiabilityMonth1": 10000,
"TaxLiabilityMonth2": 10000,
"TaxLiabilityMonth3": 4372.45
},
"SemiWeeklyDepositor": null,
"TotalQuarterTaxLiabilityAmt": 24372.45
}
},
"RecordId": null
}
],
"SubmissionId": 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
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
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
Response JSON
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "bbde2477-50d0-486b-a405-e8ca4733c00d",
"Form941Records": {
"SuccessRecords": [
{
"SequenceId": "001",
"RecordId": "3b53f4d7-294b-4ae7-9122-a9f9b4d818e2",
"RecordStatus": "Created",
"CreatedTs": "2022-03-02 06:00:06 -05:00",
"UpdatedTs": "2022-03-02 06:00:06 -05:00"
}
],
"ErrorRecords": null
},
"Errors": null
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# Delete
Deletes 941 returns by Submission Ids and Record Ids.
DELETE Form941/Delete
1
Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | guid | Unique identifier of a submission |
| RecordIds | guid[] | List of record Ids to be deleted. |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| Form941Records | object | Pulls the Form 941 records with Success and Error statuses. |
| SuccessRecords | object[] | It will show the detailed information about the success status of Form 941 Records. |
| SequenceId | 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 941 Records. |
| SequenceId | string | A unique number given by an inbound application to identify failed records. |
| RecordId | Guid | Unique identifier of a record. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error code. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error code. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
Form941/Delete?SubmissionId=fb18e869-e27b-4226-8ac0-1e9f5949cfa7&RecordIds=0496482c-64b6-47f0-875b-469b28e90055
1
Response JSON
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"Form941Records": {
"SuccessRecords": [
{
"SequenceId": "1",
"RecordId": "0496482c-64b6-47f0-875b-469b28e90055",
"RecordStatus": "DELETED",
"CreatedTs": "2022-03-02 03:59:28 -04:00",
"UpdatedTs": "2022-03-02 04:00:22 -04:00"
}
],
"ErrorRecords": null
},
"Errors": null
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
# DownloadForm8453EMP
Downloads Form 8453 EMP by Record Id.
GET Form941/DownloadForm8453EMP
1
Request Body
| Field | Type | Description |
|---|---|---|
| RecordId | guid | Unique identifier of a record. |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| RecordId | Guid | Unique identifier of a record |
| byte[] | Pulls the byte array of Form-8453 pdf records with Success and Error statuses | |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
Form941/DownloadForm8453EMP?RecordId=eed7cf65-088e-4eba-800a-dcd54c0d05bb
1
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
2
3
4
5
6
7
8
# Get
Gets information of 941 returns by Submission Id.
GET Form941/Get
1
Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | guid | Unique identifier of a submission |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| SubmissionId | guid | Unique identifier of a submission |
| Form941Records | object[] | Employer's Form 941 information. |
| RecordId | guid | Unique identifier of a record |
| SequenceId | string | A unique number given by an inbound application to identify failed records. |
| ReturnHeader | object | Identifies the supporting details of Form 941. |
| ReturnType | string | Type of the return to be filed. Enter values like FORM941, FORM941PR, FORM941SS. |
| TaxYr | string | The Tax year for which Form 941 needs to be filed. |
| Qtr | string | The Quarter for which Form 941 needs to be filed. |
| Business | object | Business Details |
| BusinessId | Guid | Optional Business Identifier (Autogenerated). |
| 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 | When IsEIN is true, use Employer Identification Number (EIN). When IsEIN is false, use Social Security Number (SSN). |
| 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. Optional for W-2/1099 and mandatory for 94X series |
| 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. 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) |
| 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 941 |
| SignatureType | string | Type of signature used to sign Form 941 Allowed values: "ONLINE_SIGN_PIN", "FORM_8453_EMP", "REPORTING_AGENT" |
| OnlineSignaturePIN | object | A 10-digit signature PIN to become an IRS authorized signer. |
| PIN | string | Sign using a 10 digit PIN received from the IRS. |
| ReportingAgentPIN | object | A 5-digit number assigned by the IRS |
| PIN | string | Sign using a 5 digit PIN received from the IRS. |
| 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 |
| IsBusinessTransferred | Boolean | When true, identifies the business as transferred. |
| BusinessTransferredDetails | object | Type of Transfer and Record Keeper details |
| Name | string | Name of the Record Keeper |
| BusinessChangeType | string | Type of Transfer. Allowed values: "SOLD", "TRANSFERRED" |
| DateOfChange | DateTime | Date of Sale / Transfer |
| NewBusinessType | string | New Business Type of the transferred business Allowed values: "ESTE", "PART", "CORP", "EORG", "SPRO" |
| NewBusinessName | string | New Business Name of the transferred business |
| IsForeign | Boolean | When true, identifies if the business has a foreign address. |
| USAddress | object | if IsForeign is false, pass US address of the business |
| Address1 | string | Employer/Payer's US address (street address or post office box of that locality) Size Range: ..35 |
| Address2 | string | Optional Employer/Payer's suite or apartmentSize Range: ..35 |
| City | string | Employer/Payer's city Size Range: ..27 |
| State | string | State code of the employer/payer. Refer Static values. Size Range: 2 Allowed values: "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" |
| ZipCd | string | Employer/Payer's zip code |
| 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 apartmentSize Range: ..35 |
| City | string | Employer/Payer's city Size Range: ..27 |
| ProvinceOrStateNm | string | Employer/Payer's province or state name. Size Range: ..30 |
| Country | string | Employer/Payer country code. Refer Static values. 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 |
| IsSeasonalEmployer | Boolean | When true, identifies if the return is for a seasonal employer and the employer don't have to file a return for every quarter of the year. |
| ReturnData | object | Identifies the Form 941 data |
| Form941 | object | Form 941, Employer's QUARTERLY Federal Tax Return |
| EmployeeCnt | number | Gets the number of Employees who has received wages, tips, or other compensation for the pay period including Mar. 12 (Quarter 1), June 12 (Quarter 2), Sept. 12 (Quarter 3), or Dec. 12 (Quarter 4). |
| WagesAmt | number | Gets the wages, tips, and other compensation for the Quarter Size Range: 0-99999999999999.99 |
| FedIncomeTaxWHAmt | number | Gets the federal income tax withheld from wages, tips, and other compensation Size Range: 0-99999999999999.99 |
| WagesNotSubjToSSMedcrTaxInd | Boolean | When true, identifies if no wages, tips, and other compensation on line 2 are subject to social security or Medicare tax. |
| SocialSecurityTaxCashWagesAmt_Col1 | number | Gets the taxable social security wages amount. Line 5a Column 1 Size Range: 0-99999999999999.99 |
| QualSickLeaveWagesAmt_Col1 | number | Qualified Sick Leave wages under SS wage base column 1. Size Range: 0-99999999999999.99 |
| QualFamilyLeaveWagesAmt_Col1 | number | Qualified Family Leave wages under SS wage base column 1. Size Range: 0-99999999999999.99 |
| TaxableSocSecTipsAmt_Col1 | number | Gets the taxable social security tips amount. Line 5b Column 1. Size Range: 0-99999999999999.99 |
| TaxableMedicareWagesTipsAmt_Col1 | number | Gets the taxable medicare wages and tips amount. Line 5c Column 1. Size Range: 0-99999999999999.99 |
| TxblWageTipsSubjAddnlMedcrAmt_Col1 | number | Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Line 5d Column 1. Size Range: 0-99999999999999.99 |
| SocialSecurityTaxAmt_Col2 | number | Gets the tax on Social Security Wages. Line 5a Column 2. Size Range: 0-99999999999999.99 |
| TaxOnQualSickLeaveWagesAmt_Col2 | number | Qualified Sick Leave wages under SS wage base column 2. Size Range: 0-99999999999999.99 |
| TaxOnQualFamilyLeaveWagesAmt_Col2 | number | Qualified Family Leave wages under SS wage base column 2. Size Range: 0-99999999999999.99 |
| TaxOnSocialSecurityTipsAmt_Col2 | number | Gets the tax on Social Security Tips. Line 5b Column 2. Size Range: 0-99999999999999.99 |
| TaxOnMedicareWagesTipsAmt_Col2 | number | Gets the tax on Taxable Medicare Wages and Tips subject to Medicare Amount. Line 5c Column 2. Size Range: 0-99999999999999.99 |
| TaxOnWageTipsSubjAddnlMedcrAmt_Col2 | number | Gets the tax on Taxable Wages and Tips subject to Additional Medicare Tax withholding amount. Line 5d Column 2. Size Range: 0-99999999999999.99 |
| TotSSMdcrTaxAmt | number | Gets the Total Social Security and Medicare Tax Amount. Line 5e. Size Range: 0-99999999999999.99 |
| TaxOnUnreportedTips3121qAmt | number | Gets the tax due from Section 3121(q) Notice and Demand on line 5f. Size Range: 0-99999999999999.99 |
| TotalTaxBeforeAdjustmentAmt | number | Gets the Total taxes before adjustments by adding the amounts on lines 3, 5e, and 5f on Line 6. Size Range: -99999999999999.99-99999999999999.99 |
| CurrentQtrFractionsCentsAmt | number | Gets the amount of current quarter's adjustment for fractions of cents. Line 7. Size Range: -99999999999999.99-99999999999999.99 |
| CurrentQuarterSickPaymentAmt | number | Gets the amount of current quarter's adjustment for sick pay. Line 8. Size Range: -99999999999999.99-99999999999999.99 |
| CurrQtrTipGrpTermLifeInsAdjAmt | number | Gets the amount of current quarter's adjustments for tips and group-term life insurance. Line 9. Size Range: -99999999999999.99-99999999999999.99 |
| TotalTaxAfterAdjustmentAmt | number | Gets the amount of Total taxes after adjustments by adding amount in line 6 through line 9. Line 10. Size Range: -99999999999999.99-99999999999999.99 |
| PayrollTaxCreditAmt | number | Gets the amount of qualified small business payroll tax credit for increasing research activities. Line 11. Size Range: 0-99999999999999.99 |
| IsPayrollTaxCredit | Boolean | When true, identifies the Line 11 is greater than zero to determine the amount of qualified small business payroll tax credit for increasing research activities that a business can claim on Form 941. |
| Form8974 | object | Information of Form 8974 |
| Form8974IncomeTaxDetails | object[] | Collection of Income Tax details |
| IncomeTaxPeriodEndDate | string | Gets the ending date of income tax period in Part 1 Column (a). |
| IncomeTaxReturnFiledForm | string | Gets the Income tax return filed to elected a qualified small business payroll tax credit on Form 6765. Form 6765 can be attached to Form 1040, 1065, 1120, 1120-F, or 1120S. Part 1 Column (b) |
| IncomeTaxReturnFiledDate | string | Gets the income tax return filing date shown in column (b). Part 1 Column (c) |
| Form6765EIN | string | Gets the EIN used on Form 6765 if the EIN used on Form 8974 doesn't match with the EIN on Form 6765. Part 1 Column (d) Size Range: 9 |
| Form6765Line44Amt | number | Gets the amount from Form 6765, line 44 or the amount allocated to your EIN if applicable. Part 1 Column (e) Size Range: 0-99999999999999.99 |
| PreviousPeriodRemainingCreditAmt | number | Gets the amount of credit from column (e) taken on a previous period(s). Part 1 Column (f) Size Range: 0-99999999999999.99 |
| RemainingCredit | number | Gets the total amount of remaining credit by subtracting column (f) from column (e). Part 1 Column (g). Size Range: 0-99999999999999.99 |
| Line7 | number | Gets the total amount from Part 1, line 6(g). Part 2 Line 7. Size Range: 0-99999999999999.99 |
| Line8 | number | Gets the total amount of social security tax on wages from Form 941, line 5a, column 2; Form 943, line 3; or Form 944, line 4a, column 2. Part 2 Line 8. Size Range: 0-99999999999999.99 |
| Line9 | number | Gets the total amount of social security tax on tips from Form 941, line 5b, column 2; or Form 944, line 4b, column 2. Part 2 Line 9. Size Range: 0-99999999999999.99 |
| Line10 | number | Gets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10. Size Range: 0-99999999999999.99 |
| Line11 | number | Gets the amount of line 10 multiplied by 50% (0.50) on line 11. If you're a third-party payer of sick pay or you received a Section 3121(q) Notice and Demand, check the applicable box on line 11. Size Range: 0-99999999999999.99 |
| PayerIndicatorType | string | Identifies if you are a Third-party payer of sick pay or received a Section 3121(q) Notice and Demand Allowed values: "THIRDPARTYSICKPAYIND", "SECTION3121QIND" |
| Line12 | number | Gets the credit amount smaller of line 7 or line 11. Also, this amount entered on Form 941 (941-PR or 941-SS), line 11; Form 943 (943-PR), line 12; or Form 944 (944(SP)), line 8 Size Range: 0-99999999999999.99 |
| NonRfdCrQualSickAndFamilyWagesB4_Apr1_2021 | number | Nonrefundable portion of credit for qualified sick and family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| NonRfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Nonrefundable portion of credit for qualified sick and family leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99 |
| NonRfdCobraPremAsstCr | number | Nonrefundable portion of COBRA premium assistance credit. Size Range: 0-99999999999999.99 |
| NumOfIndivCobraPremAsst | int | Nonrefundable portion of COBRA premium assistance credit. |
| TotlNonRfdCrAmt | number | Total nonrefundable credits. Size Range: 0-99999999999999.99 |
| TotTaxAfterAdjustmentAndNonRfdCr | number | Total taxes after adjustments and nonrefundable credits. Size Range: 0-99999999999999.99 |
| TotTaxDepositAmt | number | Gets the total deposits for the quarter, including overpayment amount applied from a prior quarter and overpayments applied by filing Form 941-X, 941-X(PR), 944-X, or 944-X(SP) filed in the current quarter. Line 13. Size Range: 0-99999999999999.99 |
| RfdCrQualSickAndFamilyWagesB4_Apr1_2021 | number | Refundable portion of credit for qualified sick and family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| RfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Refundable portion of credit for qualified sick and family leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99 |
| RfdCobraPremAsstCr | number | Refundable portion of COBRA premium assistance credit. Size Range: 0-99999999999999.99 |
| TotDepositAndRfdCrAmt | number | Total deposits and refundable credits. Size Range: 0-99999999999999.99 |
| BalanceDueAmt | number | Gets the difference amount of the balance due if line 12 is more than line 13. Line 14. Size Range: 0-99999999999999.99 |
| OverpaidAmt | number | Gets the difference overpayment amount if line 13 is more than line 12. Line 15. Size Range: 0-99999999999999.99 |
| OverPaymentRecoveryType | string | Gets the overpayment recovery type, whether to have the IRS refund the excess amount or apply it to next return. Check only one box on line 15. Allowed values: "REFUND", "APPLYTORETURN" |
| QualHealthPlanExpToSickLeaveWagesB4_Apr1_2021 | number | Qualified health plan expenses allocable to qualified sick leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| QualHealthPlanExpToFamilyLeaveWagesB4_Apr1_2021 | number | Qualified health plan expenses allocable to qualified family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| QualSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified sick leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99 |
| QualHealthPlanExpToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified health plan expenses allocable to qualified sick leave wages reported on line 23. Size Range: 0-99999999999999.99 |
| CBAToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Amounts under certain collectively bargained agreements allocable to qualified sick leave wages reported on line 23. Size Range: 0-99999999999999.99 |
| QualFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified family leave wages for leave taken after March 31, 2021 and before October 1, 2021. Size Range: 0-99999999999999.99 |
| QualHealthPlanExpToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified health plan expenses allocable to qualified family leave wages reported on line 26. Size Range: 0-99999999999999.99 |
| CBAToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Amounts under certain collectively bargained agreements allocable to qualified family leave wages reported on line 26. Size Range: 0-99999999999999.99 |
| IRSPaymentType | string | EFW, EFTPS, Check or Money Order Allowed values: "EFW", "EFTPS", "CHECK_OR_MO" |
| IRSPayment | object | Identifies the details of Electronic Funds Withdrawal (EFW) if paying the balance due along with the return |
| BankRoutingNum | string | Bank Routing Number of EFW payment Size Range: 9 |
| AccountType | string | Account Type of EFW payment Allowed values: "CHECKING", "SAVING" |
| BankAccountNum | string | Bank Account Number of EFW payment Size Range: ..17 |
| Phone | string | Phone of EFW payment Size Range: 10 |
| DepositScheduleType | object | Identifies the Employer's deposit schedule and tax liability for the quarter |
| DepositorType | string | Type of Deposit Schedule. Values like Monthly or Semi Weekly Allowed values: "MINTAXLIABILITY", "MONTHLY", "SEMIWEEKLY" |
| MonthlyDepositor | object | Line 16, Option 2. Monthly Schedule Depositor |
| TaxLiabilityMonth1 | number | Tax Liability for Month 1 of the filing quarter. |
| TaxLiabilityMonth2 | number | Tax Liability for Month 2 of the filing quarter. |
| TaxLiabilityMonth3 | number | Tax Liability for Month 3 of the filing quarter. |
| SemiWeeklyDepositor | object | Line 16, Option 3. SemiWeekly Depositor |
| ScheduleBMonth1Amt | object[] | Tax Liability for Month 1 of the filing quarter in Form Schedule B. |
| Day | string | Tax Lability Day of the month. Allowed values: "Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28", "Day29", "Day30", "Day31" |
| Amt | number | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| ScheduleBMonth2Amt | object[] | Tax Liability for Month 2 of the filing quarter in Form Schedule B. |
| Day | string | Tax Lability Day of the month. Allowed values: "Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28" |
| Amt | number | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| ScheduleBMonth3Amt | object[] | Tax Liability for Month 3 of the filing quarter in Form Schedule B. |
| Day | string | Tax Lability Day of the month. Allowed values: "Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28", "Day29", "Day30", "Day31" |
| Amt | number | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| TotalQuarterTaxLiabilityAmt | number | Total tax liability amount for the quarter. Size Range: 0-99999999999999.99 |
| ReturnNumber | string | Unique number of a return |
| Errors | object[] | Shows detailed error information |
| Id | string | Returns the validation error id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
"Form941/Get?SubmissionId=bbde2477-50d0-486b-a405-e8ca4733c00d&RecordIds=3b53f4d7-294b-4ae7-9122-a9f9b4d818e2"
1
Response JSON
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "bbde2477-50d0-486b-a405-e8ca4733c00d",
"Form941Records": [
{
"RecordId": "3b53f4d7-294b-4ae7-9122-a9f9b4d818e2",
"SequenceId": "001",
"RecordStatus": "Created",
"ReturnHeader": {
"ReturnType": "Form941",
"MoreClients": false,
"TaxYr": "2022",
"Qtr": "Q1",
"Business": {
"BusinessId": "60ab7ad1-473d-45ed-8867-48988c085259",
"PayerRef": null,
"BusinessNm": "Eastman Bridge Company",
"TradeNm": null,
"IsEIN": true,
"EINorSSN": "002352234",
"Email": "alicejohn@gmail.com",
"ContactNm": "Alice John",
"Phone": "1654798798",
"PhoneExtn": null,
"Fax": "(564) 987-9878",
"BusinessType": "CORP",
"SigningAuthority": {
"Name": "Tina Charles",
"Phone": "7498798798",
"BusinessMemberType": "PRESIDENT"
},
"KindOfEmployer": null,
"KindOfPayer": null,
"IsBusinessTerminated": false,
"IsForeign": false,
"USAddress": {
"Address1": "1751 Kinsey Rd",
"Address2": "Main St",
"City": "Dothan",
"State": "AL",
"ZipCd": "36303"
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
},
"IsGovernmentalUnit": false
},
"IsThirdPartyDesignee": false,
"ThirdPartyDesignee": null,
"SignatureDetails": {
"SignatureType": "ONLINE_SIGN_PIN",
"OnlineSignaturePIN": {
"PIN": "4564564555"
},
"ReportingAgentPIN": null,
"Form8453EMP": null
},
"BusinessStatusDetails": {
"IsBusinessClosed": false,
"BusinessClosedDetails": null,
"IsBusinessTransferred": false,
"BusinessTransferredDetails": null,
"IsSeasonalEmployer": false
}
},
"ReturnData": {
"Form941": {
"EmployeeCnt": 200,
"WagesAmt": 40000.00,
"FedIncomeTaxWHAmt": 25000.00,
"WagesNotSubjToSSMedcrTaxInd": false,
"SocialSecurityTaxCashWagesAmt_Col1": 400.00,
"QualSickLeaveWagesAmt_Col1": 300.00,
"QualFamilyLeaveWagesAmt_Col1": 200.00,
"TaxableSocSecTipsAmt_Col1": 200.00,
"TaxableMedicareWagesTipsAmt_Col1": 100.00,
"TxblWageTipsSubjAddnlMedcrAmt_Col1": 150.00,
"SocialSecurityTaxAmt_Col2": 49.60,
"TaxOnQualSickLeaveWagesAmt_Col2": 18.60,
"TaxOnQualFamilyLeaveWagesAmt_Col2": 12.40,
"TaxOnSocialSecurityTipsAmt_Col2": 24.80,
"TaxOnMedicareWagesTipsAmt_Col2": 2.90,
"TaxOnWageTipsSubjAddnlMedcrAmt_Col2": 1.35,
"TotSSMdcrTaxAmt": 109.65,
"TaxOnUnreportedTips3121qAmt": 500.00,
"TotalTaxBeforeAdjustmentAmt": 25609.65,
"CurrentQtrFractionsCentsAmt": -300.00,
"CurrentQuarterSickPaymentAmt": -200.00,
"CurrQtrTipGrpTermLifeInsAdjAmt": -100.00,
"TotalTaxAfterAdjustmentAmt": 25009.65,
"PayrollTaxCreditAmt": 37.20,
"IsPayrollTaxCredit": true,
"Form8974": {
"Form8974IncomeTaxDetails": [
{
"IncomeTaxPeriodEndDate": "7/7/2020",
"IncomeTaxReturnFiledForm": "FORM1065",
"IncomeTaxReturnFiledDate": "7/7/2020",
"Form6765EIN": "00-1287038",
"Form6765Line44Amt": 100.00,
"PreviousPeriodRemainingCreditAmt": 50.00,
"RemainingCredit": 50.00
},
{
"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": 50.00,
"Line8": 49.60,
"Line9": 24.80,
"Line10": 74.40,
"Line11": 37.20,
"PayerIndicatorType": "SECTION3121QIND",
"Line12": 37.20
},
"NonRfdCrQualSickAndFamilyWagesB4_Apr1_2021": 75.00,
"NonRfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021": 515.00,
"NonRfdCobraPremAsstCr": 10.00,
"NumOfIndivCobraPremAsst": 40,
"TotlNonRfdCrAmt": 637.20,
"TotTaxAfterAdjustmentAndNonRfdCr": 24372.45,
"TotTaxDepositAmt": 400.00,
"RfdCrQualSickAndFamilyWagesB4_Apr1_2021": 8.00,
"RfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021": 20.00,
"RfdCobraPremAsstCr": 20.00,
"TotDepositAndRfdCrAmt": 448.00,
"BalanceDueAmt": 23924.45,
"OverpaidAmt": 0.00,
"OverPaymentRecoveryType": null,
"QualHealthPlanExpToSickLeaveWagesB4_Apr1_2021": 400.25,
"QualHealthPlanExpToFamilyLeaveWagesB4_Apr1_2021": 500.25,
"QualSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 800.25,
"QualHealthPlanExpToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 0.00,
"CBAToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 500.25,
"QualFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 600.25,
"QualHealthPlanExpToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 400.25,
"CBAToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 400.25
},
"IRSPaymentType": "EFTPS",
"IRSPayment": {
"BankRoutingNum": null,
"AccountType": null,
"BankAccountNum": null,
"Phone": null
},
"DepositScheduleType": {
"DepositorType": "MONTHLY",
"MonthlyDepositor": {
"TaxLiabilityMonth1": 10000.00,
"TaxLiabilityMonth2": 10000.00,
"TaxLiabilityMonth3": 4372.45
},
"SemiWeeklyDepositor": null,
"TotalQuarterTaxLiabilityAmt": 24372.45
}
},
"ReturnNumber": "6P000612213048-192"
}
],
"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
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
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
# GetPDF
Request a PDF download of 941 to be made available through Webhooks
GET Form941/GetPDF
1
Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | string | Unique identifier of a submission |
| RecordIds | string | List of record Ids to be downloaded. |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| SubmissionId | Guid | Unique identifier of a submission |
| Form941pdfRecords | object[] | Form941pdfRecords Object |
| RecordId | Guid | Unique identifier of a record |
| SequenceId | string | An unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the Response for your reference. Size Range: 50 |
| Form941pdf | string | Returns the record ID with success message after generating a PDF. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
Form941/GetPDF?SubmissionId=8847cee7-2275-4493-a5c3-c06ed1de530c&RecordIds=f93602df-ceaf-48a4-a3cf-431bb6b6ddba
1
Response JSON
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "f2fee2f8-74bf-4e1d-9239-399e76929475",
"Form941pdfRecords": [
{
"RecordId": "ed6bc24b-189d-419b-9224-2dd2bf3b7467",
"SequenceId": "001",
"Form941pdf": "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
14
2
3
4
5
6
7
8
9
10
11
12
13
14
# List
Lists Form 941s created for a date range.
GET Form941/List
1
Request Body
| Field | Type | Description |
|---|---|---|
| BusinessId | guid | Unique identifier of a business |
| EIN | string | Employer Identification Number |
| Page | number | Pulls the page number of the page selected |
| PageSize | number | Number of 941 records to be listed in each page |
| EfileStatus | string | List the 941 records based on the status |
| FromDate | DateTime | List 941 records created from |
| ToDate | DateTime | List 941 records created up to |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| Form941Records | object[] | Returns detailed information of the Form 941 records. |
| SubmissionId | guid | Unique identifier of a submission. |
| BusinessId | guid | Unique Identifier of the business. |
| BusinessNm | string | Name of the business. |
| EIN | guid | Employer identification Number. |
| BusinessType | string | Type of the return to be filed. Like as FORM941, FORM941PR, FORM941SS. |
| RecordId | guid | Unique identifier of a record. |
| TaxYr | string | Tax year of Form 941 to be filed. |
| Qtr | string | Quarter of Form 941 to be filed. |
| IRSPaymentType | string | Payment type to make payments to the IRS. |
| EFileStatus | string | List the Form 941 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 941 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
"Form941/List?BusinessId=730f3e93-f5d8-490f-9deb-36bbf158e51c&EIN=006587034&Page=0&PageSize=0&EfileStatus=ALL&FromDate=null&ToDate=null"
1
Response JSON
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"Form941Records": [
{
"SubmissionId": "909a8bc8-f60b-4d90-8bb3-247be7179ace",
"BusinessId": "730f3e93-f5d8-490f-9deb-36bbf158e51c",
"BusinessNm": "Eastman Kodak Company",
"EIN": "006687034",
"BusinessType": "CORP",
"RecordId": "cba7aa73-6104-476d-99f7-e8ac2dea7f0a",
"TaxYr": "2022",
"Qtr": "Q1",
"IRSPaymentType": "EFTPS",
"ReturnType": "Form941",
"EFileStatus": "CREATED"
},
{
"SubmissionId": "747a8bc8-f60b-4d90-8bb3-247be7179ace",
"BusinessId": "730f3e93-f5d8-490f-9deb-36bbf158e51c",
"BusinessNm": "Eastman Kodak Company",
"EIN": "006687034",
"BusinessType": "CORP",
"RecordId": "abc7aa73-6104-476d-99f7-e8ac2dea7f0a",
"TaxYr": "2022",
"Qtr": "Q1",
"IRSPaymentType": "EFTPS",
"ReturnType": "Form941",
"EFileStatus": "CREATED"
}
],
"TotalRecords": 2,
"TotalPages": 1,
"Page": 1,
"PageSize": 100,
"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
25
26
27
28
29
30
31
32
33
34
35
36
37
38
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
# Status
Gets the status of the 941 returns by Submission Id and Record Ids.
GET Form941/Status
1
Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | guid | Unique identifier of a submission |
| RecordIds | guid[] | List of record Ids to get status. |
| ReturnType | string | Type of the return to be filed. Enter values like FORM941, FORM941PR, FORM941SS. Allowed values: "FORM941", "FORM941PR", "FORM941SS" |
| EIN | string | Employer Identification Number |
| Qtr | string | Quarter of Form 941 to be filed. Allowed values: "Q1" |
| TaxYr | string | Tax year of Form 941 to be filed. Allowed values: "2022" |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| SubmissionId | Guid | Unique identifier of a submission. |
| Form941Records | object | Pulls the Form 941 records with Success and Error statuses. |
| SuccessRecords | object[] | It will show the detailed information about the success status of Form 941 Records. |
| SequenceId | 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 941 Records. |
| RecordId | Guid | Unique identifier of a record. |
| SequenceId | string | A unique number given by an inbound application to identify failed records. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error code. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
Form941/Status?SubmissionId=f2fee2f8-74bf-4e1d-9239-399e76929475&RecordIds=ed6bc24b-189d-419b-9224-2dd2bf3b7467&ReturnType=FORM941&EIN=005534958&Qtr=Q1&TaxYear=2022
1
Response JSON
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "f2fee2f8-74bf-4e1d-9239-399e76929475",
"Form941Records": {
"SuccessRecords": [
{
"SequenceId": "01",
"RecordId": "ed6bc24b-189d-419b-9224-2dd2bf3b7467",
"RecordStatus": "Created",
"CreatedTs": "2022-03-02 03:06:07 -04:00",
"UpdatedTs": "2022-03-02 03:46:54 -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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# Transmit
Transmits the Form 941 to the IRS after validation.
POST Form941/Transmit
1
Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | guid | Unique identifier of a submission |
| RecordIds | guid[] | List of record Ids to be transmitted. |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| SubmissionId | Guid | Unique identifier of a submission. |
| Form941Records | object | Pulls the Form 941 records with Success and Error statuses. |
| SuccessRecords | object[] | It will show the detailed information about the success status of Form 941 Records. |
| SequenceId | 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 941 Records. |
| RecordId | Guid | Unique identifier of a record. |
| SequenceId | string | A unique number given by an inbound application to identify failed records. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error code. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
{
"SubmissionId": "f2fee2f8-74bf-4e1d-9239-399e76929475",
"RecordIds": [
"ed6bc24b-189d-419b-9224-2dd2bf3b7467"
]
}
1
2
3
4
5
6
2
3
4
5
6
Response JSON
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "f2fee2f8-74bf-4e1d-9239-399e76929475",
"Form941Records": {
"SuccessRecords": [
{
"SequenceId": "1",
"RecordId": "ed6bc24b-189d-419b-9224-2dd2bf3b7467",
"RecordStatus": "Transmitted",
"CreatedTs": "2022-03-02 03:06:07 -04:00",
"UpdatedTs": "2022-03-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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
# Update
Updates information of Form 941s by Submission Id and Record Id.
PUT Form941/Update
1
Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | guid | Unique identifier of a submission. |
| Form941Records | object[] | Collection of objects to update Form 941 records. |
| RecordId | guid | Unique identifier of a record. |
| SequenceId | string | A unique number given by an inbound application to identify failed records Size Range: ..10 |
| ReturnHeader | object | Identifies the supporting details of Form 941. |
| ReturnType | string | Type of the return to be filed. Enter values like FORM941, FORM941PR, FORM941SS. Allowed values: "FORM941", "FORM941PR", "FORM941SS" |
| TaxYr | string | The Tax year for which Form 941 needs to be filed. Allowed values: "2022" |
| Qtr | string | The Quarter for which Form 941 needs to be filed. Allowed values: "Q1" |
| Business | object | Business Details |
| BusinessId | Guid | Optional Business Identifier (Autogenerated). |
| BusinessNm | string | Name of the business Size Range: ..75 |
| TradeNm | string | Optional Name under which the business operatesSize 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 |
| 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 numberSize Range: ..5 |
| Fax | string | Optional Fax number of the BusinessSize 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 apartmentSize 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 apartmentSize 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 941 |
| SignatureType | string | Type of signature used to sign Form 941 Allowed values: "ONLINE_SIGN_PIN", "FORM_8453_EMP", "REPORTING_AGENT" |
| OnlineSignaturePIN | object | A 10-digit signature PIN to become an IRS authorized signer. |
| PIN | string | Sign using a 10 digit PIN received from the IRS. Size Range: 10 |
| ReportingAgentPIN | object | A 5-digit number assigned by the IRS |
| PIN | string | Sign using a 5 digit PIN received from the IRS. Size Range: 5 |
| BusinessStatusDetails | object | Identifies the status of the Business |
| IsBusinessClosed | Boolean | When true, identifies the business as terminated or stopped paying wages |
| BusinessClosedDetails | object | Identifies the Record Keeper details and date on which the 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 apartmentSize 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 apartmentSize 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 941 data |
| Form941 | object | Form 941, Employer's QUARTERLY Federal Tax Return |
| EmployeeCnt | number | Gets the number of Employees who has received wages, tips, or other compensation for the pay period including Mar. 12 (Quarter 1), June 12 (Quarter 2), Sept. 12 (Quarter 3), or Dec. 12 (Quarter 4). |
| WagesAmt | number | Gets the wages, tips, and other compensation for the Quarter Size Range: 0-99999999999999.99 |
| FedIncomeTaxWHAmt | number | Gets the federal income tax withheld from wages, tips, and other compensation Size Range: 0-99999999999999.99 |
| WagesNotSubjToSSMedcrTaxInd | Boolean | When true, identifies if no wages, tips, and other compensation on line 2 are subject to social security or Medicare tax. |
| SocialSecurityTaxCashWagesAmt_Col1 | number | Gets the taxable social security wages amount. Line 5a Column 1 Size Range: 0-99999999999999.99 |
| QualSickLeaveWagesAmt_Col1 | number | Qualified Sick Leave wages under SS wage base column 1. Size Range: 0-99999999999999.99 |
| QualFamilyLeaveWagesAmt_Col1 | number | Qualified Family Leave wages under SS wage base column 1. Size Range: 0-99999999999999.99 |
| TaxableSocSecTipsAmt_Col1 | number | Gets the taxable social security tips amount. Line 5b Column 1. Size Range: 0-99999999999999.99 |
| TaxableMedicareWagesTipsAmt_Col1 | number | Gets the taxable medicare wages and tips amount. Line 5c Column 1. Size Range: 0-99999999999999.99 |
| TxblWageTipsSubjAddnlMedcrAmt_Col1 | number | Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Line 5d Column 1. Size Range: 0-99999999999999.99 |
| SocialSecurityTaxAmt_Col2 | number | Gets the tax on Social Security Wages. Line 5a Column 2. Size Range: 0-99999999999999.99 |
| TaxOnQualSickLeaveWagesAmt_Col2 | number | Qualified Sick Leave wages under SS wage base column 2. Size Range: 0-99999999999999.99 |
| TaxOnQualFamilyLeaveWagesAmt_Col2 | number | Qualified Family Leave wages under SS wage base column 2. Size Range: 0-99999999999999.99 |
| TaxOnSocialSecurityTipsAmt_Col2 | number | Gets the tax on Social Security Tips. Line 5b Column 2. Size Range: 0-99999999999999.99 |
| TaxOnMedicareWagesTipsAmt_Col2 | number | Gets the tax on Taxable Medicare Wages and Tips subject to Medicare Amount. Line 5c Column 2. Size Range: 0-99999999999999.99 |
| TaxOnWageTipsSubjAddnlMedcrAmt_Col2 | number | Gets the tax on Taxable Wages and Tips subject to Additional Medicare Tax withholding amount. Line 5d Column 2. Size Range: 0-99999999999999.99 |
| TotSSMdcrTaxAmt | number | Gets the Total Social Security and Medicare Tax Amount. Line 5e. Size Range: 0-99999999999999.99 |
| TaxOnUnreportedTips3121qAmt | number | Gets the tax due from Section 3121(q) Notice and Demand on line 5f. Size Range: 0-99999999999999.99 |
| TotalTaxBeforeAdjustmentAmt | number | Gets the Total taxes before adjustments by adding the amounts on lines 3, 5e, and 5f on Line 6. Size Range: -99999999999999.99-99999999999999.99 |
| CurrentQtrFractionsCentsAmt | number | Gets the amount of current quarter's adjustment for fractions of cents. Line 7. Size Range: -99999999999999.99-99999999999999.99 |
| CurrentQuarterSickPaymentAmt | number | Gets the amount of current quarter's adjustment for sick pay. Line 8. Size Range: -99999999999999.99-99999999999999.99 |
| CurrQtrTipGrpTermLifeInsAdjAmt | number | Gets the amount of current quarter's adjustments for tips and group-term life insurance. Line 9. Size Range: -99999999999999.99-99999999999999.99 |
| TotalTaxAfterAdjustmentAmt | number | Gets the amount of Total taxes after adjustments by adding amount in line 6 through line 9. Line 10. Size Range: -99999999999999.99-99999999999999.99 |
| PayrollTaxCreditAmt | number | Gets the amount of qualified small business payroll tax credit for increasing research activities. Line 11. Size Range: 0-99999999999999.99 |
| IsPayrollTaxCredit | Boolean | When true, identifies the Line 11 is greater than zero to determine the amount of qualified small business payroll tax credit for increasing research activities that a business can claim on Form 941. |
| Form8974 | object | Information of Form 8974 |
| Form8974IncomeTaxDetails | object[] | Collection of Income Tax details |
| IncomeTaxPeriodEndDate | string | Gets the ending date of income tax period in Part 1 Column (a). |
| IncomeTaxReturnFiledForm | string | Gets the Income tax return filed to elected a qualified small business payroll tax credit on Form 6765. Form 6765 can be attached to Form 1040, 1065, 1120, 1120-F, or 1120S. Part 1 Column (b) |
| IncomeTaxReturnFiledDate | string | Gets the income tax return filing date shown in column (b). Part 1 Column (c) |
| Form6765EIN | string | Gets the EIN used on Form 6765 if the EIN used on Form 8974 doesn't match with the EIN on Form 6765. Part 1 Column (d) Size Range: 9 |
| Form6765Line44Amt | number | Gets the amount from Form 6765, line 44 or the amount allocated to your EIN if applicable. Part 1 Column (e) Size Range: 0-99999999999999.99 |
| PreviousPeriodRemainingCreditAmt | number | Gets the amount of credit from column (e) taken on a previous period(s). Part 1 Column (f) Size Range: 0-99999999999999.99 |
| RemainingCredit | number | Gets the total amount of remaining credit by subtracting column (f) from column (e). Part 1 Column (g). Size Range: 0-99999999999999.99 |
| Line7 | number | Gets the total amount from Part 1, line 6(g). Part 2 Line 7. Size Range: 0-99999999999999.99 |
| Line8 | number | Gets the total amount of social security tax on wages from Form 941, line 5a, column 2; Form 943, line 3; or Form 944, line 4a, column 2. Part 2 Line 8. Size Range: 0-99999999999999.99 |
| Line9 | number | Gets the total amount of social security tax on tips from Form 941, line 5b, column 2; or Form 944, line 4b, column 2. Part 2 Line 9. Size Range: 0-99999999999999.99 |
| Line10 | number | Gets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10. Size Range: 0-99999999999999.99 |
| Line11 | number | Gets the amount of line 10 multiplied by 50% (0.50) on line 11. If you're a third-party payer of sick pay or you received a Section 3121(q) Notice and Demand, check the applicable box on line 11. Size Range: 0-99999999999999.99 |
| PayerIndicatorType | string | Identifies if you are a Third-party payer of sick pay or received a Section 3121(q) Notice and Demand Allowed values: "THIRDPARTYSICKPAYIND", "SECTION3121QIND" |
| Line12 | number | Gets the credit amount smaller of line 7 or line 11. Also, this amount entered on Form 941 (941-PR or 941-SS), line 11; Form 943 (943-PR), line 12; or Form 944 (944(SP)), line 8 Size Range: 0-99999999999999.99 |
| NonRfdCrQualSickAndFamilyWagesB4_Apr1_2021 | number | Nonrefundable portion of credit for qualified sick and family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| NonRfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Nonrefundable portion of credit for qualified sick and family leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99 |
| NonRfdCobraPremAsstCr | number | Nonrefundable portion of COBRA premium assistance credit. Size Range: 0-99999999999999.99 |
| NumOfIndivCobraPremAsst | int | Nonrefundable portion of COBRA premium assistance credit. |
| TotlNonRfdCrAmt | number | Total nonrefundable credits. Size Range: 0-99999999999999.99 |
| TotTaxAfterAdjustmentAndNonRfdCr | number | Total taxes after adjustments and nonrefundable credits. Size Range: 0-99999999999999.99 |
| TotTaxDepositAmt | number | Gets the total deposits for the quarter, including overpayment amount applied from a prior quarter and overpayments applied by filing Form 941-X, 941-X(PR), 944-X, or 944-X(SP) filed in the current quarter. Line 13. Size Range: 0-99999999999999.99 |
| RfdCrQualSickAndFamilyWagesB4_Apr1_2021 | number | Refundable portion of credit for qualified sick and family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| RfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Refundable portion of credit for qualified sick and family leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99 |
| RfdCobraPremAsstCr | number | Refundable portion of COBRA premium assistance credit. Size Range: 0-99999999999999.99 |
| TotDepositAndRfdCrAmt | number | Total deposits and refundable credits. Size Range: 0-99999999999999.99 |
| BalanceDueAmt | number | Gets the difference amount of the balance due if line 12 is more than line 13. Line 14. Size Range: 0-99999999999999.99 |
| OverpaidAmt | number | Gets the difference overpayment amount if line 13 is more than line 12. Line 15. Size Range: 0-99999999999999.99 |
| OverPaymentRecoveryType | string | Gets the overpayment recovery type, whether to have the IRS refund the excess amount or apply it to next return. Check only one box on line 15. Allowed values: "REFUND", "APPLYTORETURN" |
| QualHealthPlanExpToSickLeaveWagesB4_Apr1_2021 | number | Qualified health plan expenses allocable to qualified sick leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| QualHealthPlanExpToFamilyLeaveWagesB4_Apr1_2021 | number | Qualified health plan expenses allocable to qualified family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| QualSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified sick leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99 |
| QualHealthPlanExpToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified health plan expenses allocable to qualified sick leave wages reported on line 23. Size Range: 0-99999999999999.99 |
| CBAToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Amounts under certain collectively bargained agreements allocable to qualified sick leave wages reported on line 23. Size Range: 0-99999999999999.99 |
| QualFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified family leave wages for leave taken after March 31, 2021 and before October 1, 2021. Size Range: 0-99999999999999.99 |
| QualHealthPlanExpToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified health plan expenses allocable to qualified family leave wages reported on line 26. Size Range: 0-99999999999999.99 |
| CBAToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Amounts under certain collectively bargained agreements allocable to qualified family leave wages reported on line 26. Size Range: 0-99999999999999.99 |
| IRSPaymentType | string | EFW, EFTPS, Check or Money Order Allowed values: "EFW", "EFTPS", "CHECK_OR_MO" |
| IRSPayment | object | Identifies the details of Electronic Funds Withdrawal (EFW) if paying the balance due along with the return |
| BankRoutingNum | string | Bank Routing Number of EFW payment Size Range: 9 |
| AccountType | string | Account Type of EFW payment Allowed values: "CHECKING", "SAVING" |
| BankAccountNum | string | Bank Account Number of EFW payment Size Range: ..17 |
| Phone | string | Phone of EFW payment Size Range: 10 |
| DepositScheduleType | object | Identifies the Employer's deposit schedule and tax liability for the quarter |
| DepositorType | string | Type of Deposit Schedule. Values like Monthly or Semi Weekly Allowed values: "MINTAXLIABILITY", "MONTHLY", "SEMIWEEKLY" |
| MonthlyDepositor | object | Line 16, Option 2. Monthly Schedule Depositor |
| TaxLiabilityMonth1 | number | Tax Liability for Month 1 of the filing quarter. |
| TaxLiabilityMonth2 | number | Tax Liability for Month 2 of the filing quarter. |
| TaxLiabilityMonth3 | number | Tax Liability for Month 3 of the filing quarter. |
| SemiWeeklyDepositor | object | Line 16, Option 3. SemiWeekly Depositor |
| ScheduleBMonth1Amt | object[] | Tax Liability for Month 1 of the filing quarter in Form Schedule B. |
| Day | string | Tax Lability Day of the month. Allowed values: "Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28", "Day29", "Day30", "Day31" |
| Amt | number | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| ScheduleBMonth2Amt | object[] | Tax Liability for Month 2 of the filing quarter in Form Schedule B. |
| Day | string | Tax Lability Day of the month. Allowed values: "Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28" |
| Amt | number | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| ScheduleBMonth3Amt | object[] | Tax Liability for Month 3 of the filing quarter in Form Schedule B. |
| Day | string | Tax Lability Day of the month. Allowed values: "Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28", "Day29", "Day30", "Day31" |
| Amt | number | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| TotalQuarterTaxLiabilityAmt | number | Total tax liability amount for the quarter. Size Range: 0-99999999999999.99 |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| SubmissionId | Guid | Unique identifier of a submission. |
| Form941Records | object | Pulls the Form 941 records with Success and Error statuses. |
| SuccessRecords | object[] | It will show the detailed information about the success status of Form 941 Records. |
| SequenceId | 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 941 Records. |
| RecordId | Guid | Unique identifier of a record. |
| SequenceId | string | A unique number given by an inbound application to identify failed records. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
{
"Form941Records": [
{
"SequenceId": "256",
"ReturnHeader": {
"ReturnType": "FORM941",
"TaxYr": "2022",
"Qtr": "Q1",
"Business": {
"BusinessId": null,
"BusinessNm": "Mileston Bridge Company",
"TradeNm": null,
"IsEIN": true,
"EINorSSN": "004420534",
"Email": "Jack Clayton@gmail.com",
"ContactNm": "Jack Clayton",
"Phone": "1654798798",
"PhoneExtn": null,
"Fax": "5649879878",
"BusinessType": "CORP",
"SigningAuthority": {
"Name": "Tina Charles",
"Phone": "7498798798",
"BusinessMemberType": "PRESIDENT"
},
"KindOfEmployer": null,
"KindOfPayer": null,
"IsBusinessTerminated": false,
"IsForeign": false,
"USAddress": {
"Address1": "1751 Kinsey Rd",
"Address2": "Main St",
"City": "Dothan",
"State": "AL",
"ZipCd": "36303"
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
}
},
"IsThirdPartyDesignee": false,
"ThirdPartyDesignee": {
"Name": null,
"Phone": null,
"PIN": null
},
"SignatureDetails": {
"SignatureType": "ONLINE_SIGN_PIN",
"OnlineSignaturePIN": {
"PIN": "4564564555"
},
"ReportingAgentPIN": {
"PIN": null
},
"Form8453EMP": null
},
"BusinessStatusDetails": {
"IsBusinessClosed": false,
"BusinessClosedDetails": {
"Name": null,
"FinalDateWagesPaid": null,
"IsForeign": false,
"USAddress": {
"Address1": null,
"Address2": null,
"City": null,
"State": null,
"ZipCd": null
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
}
},
"IsBusinessTransferred": false,
"BusinessTransferredDetails": {
"Name": null,
"BusinessChangeType": null,
"DateOfChange": null,
"NewBusinessType": null,
"NewBusinessName": null,
"IsForeign": false,
"USAddress": {
"Address1": null,
"Address2": null,
"City": null,
"State": null,
"ZipCd": null
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
}
},
"IsSeasonalEmployer": false
}
},
"ReturnData": {
"Form941": {
"EmployeeCnt": 200,
"WagesAmt": 40000,
"FedIncomeTaxWHAmt": 25000,
"WagesNotSubjToSSMedcrTaxInd": false,
"SocialSecurityTaxCashWagesAmt_Col1": 400,
"QualSickLeaveWagesAmt_Col1": 300,
"QualFamilyLeaveWagesAmt_Col1": 200,
"TaxableSocSecTipsAmt_Col1": 200,
"TaxableMedicareWagesTipsAmt_Col1": 100,
"TxblWageTipsSubjAddnlMedcrAmt_Col1": 150,
"SocialSecurityTaxAmt_Col2": 49.6,
"TaxOnQualSickLeaveWagesAmt_Col2": 18.6,
"TaxOnQualFamilyLeaveWagesAmt_Col2": 12.4,
"TaxOnSocialSecurityTipsAmt_Col2": 24.8,
"TaxOnMedicareWagesTipsAmt_Col2": 2.9,
"TaxOnWageTipsSubjAddnlMedcrAmt_Col2": 1.35,
"TotSSMdcrTaxAmt":109.65,
"TaxOnUnreportedTips3121qAmt": 500,
"TotalTaxBeforeAdjustmentAmt": 25609.65,
"CurrentQtrFractionsCentsAmt": -300,
"CurrentQuarterSickPaymentAmt": -200,
"CurrQtrTipGrpTermLifeInsAdjAmt": -100,
"TotalTaxAfterAdjustmentAmt": 25009.65,
"PayrollTaxCreditAmt": 37.2,
"IsPayrollTaxCredit": true,
"Form8974": {
"Form8974IncomeTaxDetails": [
{
"IncomeTaxPeriodEndDate": "07-07-2020",
"IncomeTaxReturnFiledForm": "FORM1065",
"IncomeTaxReturnFiledDate": "07-07-2020",
"Form6765EIN": "001287038",
"Form6765Line44Amt": 100,
"PreviousPeriodRemainingCreditAmt": 50,
"RemainingCredit": 50
}
],
"Line7": 50,
"Line8": 49.6,
"Line9": 24.8,
"Line10": 74.4,
"Line11": 37.2,
"PayerIndicatorType": "SECTION3121QIND",
"Line12": 37.2
},
"NonRfdCrQualSickAndFamilyWagesB4_Apr1_2021": 75,
"NonRfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021": 515,
"NonRfdCobraPremAsstCr": 10,
"NumOfIndivCobraPremAsst": 40,
"TotlNonRfdCrAmt": 637.2,
"TotTaxAfterAdjustmentAndNonRfdCr": 24372.45,
"TotTaxDepositAmt": 400,
"RfdCrQualSickAndFamilyWagesB4_Apr1_2021": 8,
"RfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021": 20,
"RfdCobraPremAsstCr": 20,
"TotDepositAndRfdCrAmt": 448,
"BalanceDueAmt": 23924.45,
"OverpaidAmt": 0,
"OverPaymentRecoveryType": null,
"QualHealthPlanExpToSickLeaveWagesB4_Apr1_2021": 400.25,
"QualHealthPlanExpToFamilyLeaveWagesB4_Apr1_2021": 500.25,
"QualSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 800.25,
"QualHealthPlanExpToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 0,
"CBAToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 500.25,
"QualFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 600.25,
"QualHealthPlanExpToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 400.25,
"CBAToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 400.25
},
"IRSPaymentType": "EFTPS",
"IRSPayment": {
"BankRoutingNum": null,
"AccountType": null,
"BankAccountNum": null,
"Phone": null
},
"DepositScheduleType": {
"DepositorType": "MONTHLY",
"MonthlyDepositor": {
"TaxLiabilityMonth1": 10000,
"TaxLiabilityMonth2": 10000,
"TaxLiabilityMonth3": 4372.45
},
"SemiWeeklyDepositor": null,
"TotalQuarterTaxLiabilityAmt": 24372.45
}
},
"RecordId": "3b53f4d7-294b-4ae7-9122-a9f9b4d818e2"
}
],
"SubmissionId": "bbde2477-50d0-486b-a405-e8ca4733c00d"
}
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
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
Response JSON
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "bbde2477-50d0-486b-a405-e8ca4733c00d",
"Form941Records": {
"SuccessRecords": [
{
"SequenceId": "001",
"RecordId": "3b53f4d7-294b-4ae7-9122-a9f9b4d818e2",
"RecordStatus": "Created",
"CreatedTs": "2022-03-02 06:00:06 -05:00",
"UpdatedTs": "2022-03-02 06:19:00 -05:00"
}
],
"ErrorRecords": null
},
"Errors": null
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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 Form941/UploadForm8453EMP
1
Request Body
| Field | Type | Description |
|---|---|---|
| RecordId | guid | Unique identifier of a record |
| Form8453EMPPdf | byte[] | Byte array of Form-8453 pdf |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| RecordId | Guid | Unique identifier of a record |
| Form8453EMPPdf | string | Pulls Form 8453 Pdf success and error status messages |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error code. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
{
"RecordId": "eed7cf65-088e-4eba-800a-dcd54c0d05bb",
"Form8453EMPPdf":"QEA="
}
1
2
3
4
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
2
3
4
5
6
7
8
# Validate
Runs business and data validation checks for the 941 forms already created in API. You must use the Submission ID of the return to Validate.
GET Form941/Validate
1
Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | guid | Unique identifier of a submission |
| RecordIds | guid[] | Unique identifier of a record |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| SubmissionId | Guid | Unique identifier of a submission. |
| Form941Records | object | Pulls the Form 941 records with Success and Error statuses. |
| SuccessRecords | object[] | It will show the detailed information about the success status of Form 941 Records. |
| SequenceId | 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 941 Records. |
| RecordId | Guid | Unique identifier of a record. |
| SequenceId | string | A unique number given by an inbound application to identify failed records. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
Form941/Validate?SubmissionId=bbde2477-50d0-486b-a405-e8ca4733c00d&RecordIds=f93602df-ceaf-48a4-a3cf-431bb6b6ddba
1
Response JSON
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "bbde2477-50d0-486b-a405-e8ca4733c00d",
"Form941Records": {
"SuccessRecords": [
{
"SequenceId": "001",
"RecordId": "f93602df-ceaf-48a4-a3cf-431bb6b6ddba",
"RecordStatus": "Created",
"CreatedTs": "2022-03-02 06:00:06 -05:00",
"UpdatedTs": "2022-03-02 06:19:00 -05:00"
}
],
"ErrorRecords": null
},
"Errors": null
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
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 941 forms.
POST Form941/ValidateForm
1
Request Body
| Field | Type | Description |
|---|---|---|
| Form941Records | object[] | Object to create 941s |
| SequenceId | string | A unique number given by an inbound application to identify failed records Size Range: ..10 |
| ReturnHeader | object | Identifies the supporting details of Form 941. |
| ReturnType | string | Type of the return to be filed. Enter values like FORM941, FORM941PR, FORM941SS. Allowed values: "FORM941", "FORM941PR", "FORM941SS" |
| TaxYr | string | The Tax year for which Form 941 needs to be filed. Allowed values: "2022" |
| Qtr | string | The Quarter for which Form 941 needs to be filed. Allowed values: "Q1" |
| Business | object | Business Details |
| BusinessId | Guid | Optional Business Identifier (Autogenerated). |
| BusinessNm | string | Name of the business Size Range: ..75 |
| TradeNm | string | Optional Name under which the business operatesSize 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 |
| 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 numberSize Range: ..5 |
| Fax | string | Optional Fax number of the BusinessSize 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 apartmentSize 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 apartmentSize 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 941 |
| SignatureType | string | Type of signature used to sign Form 941 Allowed values: "ONLINE_SIGN_PIN", "FORM_8453_EMP", "REPORTING_AGENT" |
| OnlineSignaturePIN | object | A 10-digit signature PIN to become an IRS authorized signer. |
| PIN | string | Sign using a 10 digit PIN received from the IRS. 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 apartmentSize 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 apartmentSize 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 | When true, identifies the business as transferred. |
| BusinessTransferredDetails | object | Type of Transfer and Record Keeper details |
| Name | string | Name of the Record Keeper |
| BusinessChangeType | string | Type of Transfer. Allowed values: "SOLD", "TRANSFERRED" |
| DateOfChange | DateTime | Date of Sale / Transfer |
| NewBusinessType | string | New Business Type of the transferred business Allowed values: "ESTE", "PART", "CORP", "EORG", "SPRO" |
| NewBusinessName | string | New Business Name of the transferred business |
| IsForeign | Boolean | When true, identifies if the business has a foreign address. |
| USAddress | object | if IsForeign is false, pass US address of the business |
| Address1 | string | Employer/Payer's US address (street address or post office box of that locality) Size Range: ..35 |
| Address2 | string | Optional Employer/Payer's suite or apartmentSize Range: ..35 |
| City | string | Employer/Payer's city Size Range: ..27 |
| State | string | State code of the employer/payer. Refer Static values. Size Range: 2 Allowed values: "AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP" |
| ZipCd | string | Employer/Payer's zip code |
| 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 apartmentSize Range: ..35 |
| City | string | Employer/Payer's city Size Range: ..27 |
| ProvinceOrStateNm | string | Employer/Payer's province or state name. Size Range: ..30 |
| Country | string | Employer/Payer country code. Refer Static values. 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 |
| IsSeasonalEmployer | Boolean | When true, identifies if the return is for a seasonal employer and the employer don't have to file a return for every quarter of the year. |
| ReturnData | object | Identifies the Form 941 data |
| Form941 | object | Form 941, Employer's QUARTERLY Federal Tax Return |
| EmployeeCnt | number | Gets the number of Employees who has received wages, tips, or other compensation for the pay period including Mar. 12 (Quarter 1), June 12 (Quarter 2), Sept. 12 (Quarter 3), or Dec. 12 (Quarter 4). |
| WagesAmt | number | Gets the wages, tips, and other compensation for the Quarter Size Range: 0-99999999999999.99 |
| FedIncomeTaxWHAmt | number | Gets the federal income tax withheld from wages, tips, and other compensation Size Range: 0-99999999999999.99 |
| WagesNotSubjToSSMedcrTaxInd | Boolean | When true, identifies if no wages, tips, and other compensation on line 2 are subject to social security or Medicare tax. |
| SocialSecurityTaxCashWagesAmt_Col1 | number | Gets the taxable social security wages amount. Line 5a Column 1 Size Range: 0-99999999999999.99 |
| QualSickLeaveWagesAmt_Col1 | number | Qualified Sick Leave wages under SS wage base column 1. Size Range: 0-99999999999999.99 |
| QualFamilyLeaveWagesAmt_Col1 | number | Qualified Family Leave wages under SS wage base column 1. Size Range: 0-99999999999999.99 |
| TaxableSocSecTipsAmt_Col1 | number | Gets the taxable social security tips amount. Line 5b Column 1. Size Range: 0-99999999999999.99 |
| TaxableMedicareWagesTipsAmt_Col1 | number | Gets the taxable medicare wages and tips amount. Line 5c Column 1. Size Range: 0-99999999999999.99 |
| TxblWageTipsSubjAddnlMedcrAmt_Col1 | number | Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Line 5d Column 1. Size Range: 0-99999999999999.99 |
| SocialSecurityTaxAmt_Col2 | number | Gets the tax on Social Security Wages. Line 5a Column 2. Size Range: 0-99999999999999.99 |
| TaxOnQualSickLeaveWagesAmt_Col2 | number | Qualified Sick Leave wages under SS wage base column 2. Size Range: 0-99999999999999.99 |
| TaxOnQualFamilyLeaveWagesAmt_Col2 | number | Qualified Family Leave wages under SS wage base column 2. Size Range: 0-99999999999999.99 |
| TaxOnSocialSecurityTipsAmt_Col2 | number | Gets the tax on Social Security Tips. Line 5b Column 2. Size Range: 0-99999999999999.99 |
| TaxOnMedicareWagesTipsAmt_Col2 | number | Gets the tax on Taxable Medicare Wages and Tips subject to Medicare Amount. Line 5c Column 2. Size Range: 0-99999999999999.99 |
| TaxOnWageTipsSubjAddnlMedcrAmt_Col2 | number | Gets the tax on Taxable Wages and Tips subject to Additional Medicare Tax withholding amount. Line 5d Column 2. Size Range: 0-99999999999999.99 |
| TotSSMdcrTaxAmt | number | Gets the Total Social Security and Medicare Tax Amount. Line 5e. Size Range: 0-99999999999999.99 |
| TaxOnUnreportedTips3121qAmt | number | Gets the tax due from Section 3121(q) Notice and Demand on line 5f. Size Range: 0-99999999999999.99 |
| TotalTaxBeforeAdjustmentAmt | number | Gets the Total taxes before adjustments by adding the amounts on lines 3, 5e, and 5f on Line 6. Size Range: -99999999999999.99-99999999999999.99 |
| CurrentQtrFractionsCentsAmt | number | Gets the amount of current quarter's adjustment for fractions of cents. Line 7. Size Range: -99999999999999.99-99999999999999.99 |
| CurrentQuarterSickPaymentAmt | number | Gets the amount of current quarter's adjustment for sick pay. Line 8. Size Range: -99999999999999.99-99999999999999.99 |
| CurrQtrTipGrpTermLifeInsAdjAmt | number | Gets the amount of current quarter's adjustments for tips and group-term life insurance. Line 9. Size Range: -99999999999999.99-99999999999999.99 |
| TotalTaxAfterAdjustmentAmt | number | Gets the amount of Total taxes after adjustments by adding amount in line 6 through line 9. Line 10. Size Range: -99999999999999.99-99999999999999.99 |
| PayrollTaxCreditAmt | number | Gets the amount of qualified small business payroll tax credit for increasing research activities. Line 11. Size Range: 0-99999999999999.99 |
| IsPayrollTaxCredit | Boolean | When true, identifies the Line 11 is greater than zero to determine the amount of qualified small business payroll tax credit for increasing research activities that a business can claim on Form 941. |
| Form8974 | object | Information of Form 8974 |
| Form8974IncomeTaxDetails | object[] | Collection of Income Tax details |
| IncomeTaxPeriodEndDate | string | Gets the ending date of income tax period in Part 1 Column (a). |
| IncomeTaxReturnFiledForm | string | Gets the Income tax return filed to elected a qualified small business payroll tax credit on Form 6765. Form 6765 can be attached to Form 1040, 1065, 1120, 1120-F, or 1120S. Part 1 Column (b) |
| IncomeTaxReturnFiledDate | string | Gets the income tax return filing date shown in column (b). Part 1 Column (c) |
| Form6765EIN | string | Gets the EIN used on Form 6765 if the EIN used on Form 8974 doesn't match with the EIN on Form 6765. Part 1 Column (d) Size Range: 9 |
| Form6765Line44Amt | number | Gets the amount from Form 6765, line 44 or the amount allocated to your EIN if applicable. Part 1 Column (e) Size Range: 0-99999999999999.99 |
| PreviousPeriodRemainingCreditAmt | number | Gets the amount of credit from column (e) taken on a previous period(s). Part 1 Column (f) Size Range: 0-99999999999999.99 |
| RemainingCredit | number | Gets the total amount of remaining credit by subtracting column (f) from column (e). Part 1 Column (g). Size Range: 0-99999999999999.99 |
| Line7 | number | Gets the total amount from Part 1, line 6(g). Part 2 Line 7. Size Range: 0-99999999999999.99 |
| Line8 | number | Gets the total amount of social security tax on wages from Form 941, line 5a, column 2; Form 943, line 3; or Form 944, line 4a, column 2. Part 2 Line 8. Size Range: 0-99999999999999.99 |
| Line9 | number | Gets the total amount of social security tax on tips from Form 941, line 5b, column 2; or Form 944, line 4b, column 2. Part 2 Line 9. Size Range: 0-99999999999999.99 |
| Line10 | number | Gets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10. Size Range: 0-99999999999999.99 |
| Line11 | number | Gets the amount of line 10 multiplied by 50% (0.50) on line 11. If you're a third-party payer of sick pay or you received a Section 3121(q) Notice and Demand, check the applicable box on line 11. Size Range: 0-99999999999999.99 |
| PayerIndicatorType | string | Identifies if you are a Third-party payer of sick pay or received a Section 3121(q) Notice and Demand Allowed values: "THIRDPARTYSICKPAYIND", "SECTION3121QIND" |
| Line12 | number | Gets the credit amount smaller of line 7 or line 11. Also, this amount entered on Form 941 (941-PR or 941-SS), line 11; Form 943 (943-PR), line 12; or Form 944 (944(SP)), line 8 Size Range: 0-99999999999999.99 |
| NonRfdCrQualSickAndFamilyWagesB4_Apr1_2021 | number | Nonrefundable portion of credit for qualified sick and family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| NonRfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Nonrefundable portion of credit for qualified sick and family leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99 |
| NonRfdCobraPremAsstCr | number | Nonrefundable portion of COBRA premium assistance credit. Size Range: 0-99999999999999.99 |
| NumOfIndivCobraPremAsst | int | Nonrefundable portion of COBRA premium assistance credit. |
| TotlNonRfdCrAmt | number | Total nonrefundable credits. Size Range: 0-99999999999999.99 |
| TotTaxAfterAdjustmentAndNonRfdCr | number | Total taxes after adjustments and nonrefundable credits. Size Range: 0-99999999999999.99 |
| TotTaxDepositAmt | number | Gets the total deposits for the quarter, including overpayment amount applied from a prior quarter and overpayments applied by filing Form 941-X, 941-X(PR), 944-X, or 944-X(SP) filed in the current quarter. Line 13. Size Range: 0-99999999999999.99 |
| RfdCrQualSickAndFamilyWagesB4_Apr1_2021 | number | Refundable portion of credit for qualified sick and family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| RfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Refundable portion of credit for qualified sick and family leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99 |
| RfdCobraPremAsstCr | number | Refundable portion of COBRA premium assistance credit. Size Range: 0-99999999999999.99 |
| TotDepositAndRfdCrAmt | number | Total deposits and refundable credits. Size Range: 0-99999999999999.99 |
| BalanceDueAmt | number | Gets the difference amount of the balance due if line 12 is more than line 13. Line 14. Size Range: 0-99999999999999.99 |
| OverpaidAmt | number | Gets the difference overpayment amount if line 13 is more than line 12. Line 15. Size Range: 0-99999999999999.99 |
| OverPaymentRecoveryType | string | Gets the overpayment recovery type, whether to have the IRS refund the excess amount or apply it to next return. Check only one box on line 15. Allowed values: "REFUND", "APPLYTORETURN" |
| QualHealthPlanExpToSickLeaveWagesB4_Apr1_2021 | number | Qualified health plan expenses allocable to qualified sick leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| QualHealthPlanExpToFamilyLeaveWagesB4_Apr1_2021 | number | Qualified health plan expenses allocable to qualified family leave wages for leave taken before April 1, 2021. Size Range: 0-99999999999999.99 |
| QualSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified sick leave wages for leave taken after March 31, 2021 and Before October 1, 2021. Size Range: 0-99999999999999.99 |
| QualHealthPlanExpToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified health plan expenses allocable to qualified sick leave wages reported on line 23. Size Range: 0-99999999999999.99 |
| CBAToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Amounts under certain collectively bargained agreements allocable to qualified sick leave wages reported on line 23. Size Range: 0-99999999999999.99 |
| QualFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified family leave wages for leave taken after March 31, 2021 and before October 1, 2021. Size Range: 0-99999999999999.99 |
| QualHealthPlanExpToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Qualified health plan expenses allocable to qualified family leave wages reported on line 26. Size Range: 0-99999999999999.99 |
| CBAToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021 | number | Amounts under certain collectively bargained agreements allocable to qualified family leave wages reported on line 26. Size Range: 0-99999999999999.99 |
| IRSPaymentType | string | EFW, EFTPS, Check or Money Order Allowed values: "EFW", "EFTPS", "CHECK_OR_MO" |
| IRSPayment | object | Identifies the details of Electronic Funds Withdrawal (EFW) if paying the balance due along with the return |
| BankRoutingNum | string | Bank Routing Number of EFW payment Size Range: 9 |
| AccountType | string | Account Type of EFW payment Allowed values: "CHECKING", "SAVING" |
| BankAccountNum | string | Bank Account Number of EFW payment Size Range: ..17 |
| Phone | string | Phone of EFW payment Size Range: 10 |
| DepositScheduleType | object | Identifies the Employer's deposit schedule and tax liability for the quarter |
| DepositorType | string | Type of Deposit Schedule. Values like Monthly or Semi Weekly Allowed values: "MINTAXLIABILITY", "MONTHLY", "SEMIWEEKLY" |
| MonthlyDepositor | object | Line 16, Option 2. Monthly Schedule Depositor |
| TaxLiabilityMonth1 | number | Tax Liability for Month 1 of the filing quarter. |
| TaxLiabilityMonth2 | number | Tax Liability for Month 2 of the filing quarter. |
| TaxLiabilityMonth3 | number | Tax Liability for Month 3 of the filing quarter. |
| SemiWeeklyDepositor | object | Line 16, Option 3. SemiWeekly Depositor |
| ScheduleBMonth1Amt | object[] | Tax Liability for Month 1 of the filing quarter in Form Schedule B. |
| Day | string | Tax Lability Day of the month. Allowed values: "Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28", "Day29", "Day30", "Day31" |
| Amt | number | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| ScheduleBMonth2Amt | object[] | Tax Liability for Month 2 of the filing quarter in Form Schedule B. |
| Day | string | Tax Lability Day of the month. Allowed values: "Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28" |
| Amt | number | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| ScheduleBMonth3Amt | object[] | Tax Liability for Month 3 of the filing quarter in Form Schedule B. |
| Day | string | Tax Lability Day of the month. Allowed values: "Day1", "Day2", "Day3", "Day4", "Day5", "Day6", "Day7", "Day8", "Day9", "Day10", "Day11", "Day12", "Day13", "Day14", "Day15", "Day16", "Day17", "Day18", "Day19", "Day20", "Day21", "Day22", "Day23", "Day24", "Day25", "Day26", "Day27", "Day28", "Day29", "Day30", "Day31" |
| Amt | number | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| TotalQuarterTaxLiabilityAmt | number | Total tax liability amount for the quarter. Size Range: 0-99999999999999.99 |
Response Body
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| ErrorRecords | object[] | It will show the detailed information about the error status of Form 941 Records. |
| SequenceId | string | Shows detailed error information. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Shows detailed error information. |
| Name | string | Shows detailed error information. |
| Message | string | Shows detailed error information. |
| Errors | object[] | Shows detailed error information. |
| Id | string | Returns the validation error id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Request JSON
{
"Form941Records": [
{
"SequenceId": "001",
"ReturnHeader": {
"ReturnType": "FORM941",
"TaxYr": "2022",
"Qtr": "Q1",
"Business": {
"BusinessId": null,
"BusinessNm": "Eastman Bridge Company",
"TradeNm": null,
"IsEIN": true,
"EINorSSN": "002352234",
"Email": "alicejohn@gmail.com",
"ContactNm": "Alice John",
"Phone": "1654798798",
"PhoneExtn": null,
"Fax": "5649879878",
"BusinessType": "CORP",
"SigningAuthority": {
"Name": "Tina Charles",
"Phone": "7498798798",
"BusinessMemberType": "PRESIDENT"
},
"KindOfEmployer": null,
"KindOfPayer": null,
"IsBusinessTerminated": false,
"IsForeign": false,
"USAddress": {
"Address1": "1751 Kinsey Rd",
"Address2": "Main St",
"City": "Dothan",
"State": "AL",
"ZipCd": "36303"
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
}
},
"IsThirdPartyDesignee": false,
"ThirdPartyDesignee": {
"Name": null,
"Phone": null,
"PIN": null
},
"SignatureDetails": {
"SignatureType": "ONLINE_SIGN_PIN",
"OnlineSignaturePIN": {
"PIN": "4564564555"
},
"ReportingAgentPIN": {
"PIN": null
},
"Form8453EMP": null
},
"BusinessStatusDetails": {
"IsBusinessClosed": false,
"BusinessClosedDetails": {
"Name": null,
"FinalDateWagesPaid": null,
"IsForeign": false,
"USAddress": {
"Address1": null,
"Address2": null,
"City": null,
"State": null,
"ZipCd": null
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
}
},
"IsBusinessTransferred": false,
"BusinessTransferredDetails": {
"Name": null,
"BusinessChangeType": null,
"DateOfChange": null,
"NewBusinessType": null,
"NewBusinessName": null,
"IsForeign": false,
"USAddress": {
"Address1": null,
"Address2": null,
"City": null,
"State": null,
"ZipCd": null
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
}
},
"IsSeasonalEmployer": false
}
},
"ReturnData": {
"Form941": {
"EmployeeCnt": 200,
"WagesAmt": 40000,
"FedIncomeTaxWHAmt": 25000,
"WagesNotSubjToSSMedcrTaxInd": false,
"SocialSecurityTaxCashWagesAmt_Col1": 400,
"QualSickLeaveWagesAmt_Col1": 300,
"QualFamilyLeaveWagesAmt_Col1": 200,
"TaxableSocSecTipsAmt_Col1": 200,
"TaxableMedicareWagesTipsAmt_Col1": 100,
"TxblWageTipsSubjAddnlMedcrAmt_Col1": 150,
"SocialSecurityTaxAmt_Col2": 49.6,
"TaxOnQualSickLeaveWagesAmt_Col2": 18.6,
"TaxOnQualFamilyLeaveWagesAmt_Col2": 12.4,
"TaxOnSocialSecurityTipsAmt_Col2": 24.8,
"TaxOnMedicareWagesTipsAmt_Col2": 2.9,
"TaxOnWageTipsSubjAddnlMedcrAmt_Col2": 1.35,
"TotSSMdcrTaxAmt": 109.65,
"TaxOnUnreportedTips3121qAmt": 500,
"TotalTaxBeforeAdjustmentAmt": 25609.65,
"CurrentQtrFractionsCentsAmt": -300,
"CurrentQuarterSickPaymentAmt": -200,
"CurrQtrTipGrpTermLifeInsAdjAmt": -100,
"TotalTaxAfterAdjustmentAmt": 25009.65,
"PayrollTaxCreditAmt": 37.2,
"IsPayrollTaxCredit": true,
"Form8974": {
"Form8974IncomeTaxDetails": [
{
"IncomeTaxPeriodEndDate": "07-07-2020",
"IncomeTaxReturnFiledForm": "FORM1065",
"IncomeTaxReturnFiledDate": "07-07-2020",
"Form6765EIN": "001287038",
"Form6765Line44Amt": 100,
"PreviousPeriodRemainingCreditAmt": 50,
"RemainingCredit": 50
}
],
"Line7": 50,
"Line8": 49.6,
"Line9": 24.8,
"Line10": 74.4,
"Line11": 37.2,
"PayerIndicatorType": "SECTION3121QIND",
"Line12": 37.2
},
"NonRfdCrQualSickAndFamilyWagesB4_Apr1_2021": 75,
"NonRfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021": 515,
"NonRfdCobraPremAsstCr": 10,
"NumOfIndivCobraPremAsst": 40,
"TotlNonRfdCrAmt": 637.2,
"TotTaxAfterAdjustmentAndNonRfdCr": 24372.45,
"TotTaxDepositAmt": 400,
"RfdCrQualSickAndFamilyWagesB4_Apr1_2021": 8,
"RfdCrQualSickAndFamilyWagesAfter_Mar31_2021AndB4_Oct1_2021": 20,
"RfdCobraPremAsstCr": 20,
"TotDepositAndRfdCrAmt": 448,
"BalanceDueAmt": 23924.45,
"OverpaidAmt": 0,
"OverPaymentRecoveryType": null,
"QualHealthPlanExpToSickLeaveWagesB4_Apr1_2021": 400.25,
"QualHealthPlanExpToFamilyLeaveWagesB4_Apr1_2021": 500.25,
"QualSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 800.25,
"QualHealthPlanExpToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 0,
"CBAToSickLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 500.25,
"QualFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 600.25,
"QualHealthPlanExpToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 400.25,
"CBAToFamilyLeaveWagesAfter_Mar31_2021AndB4_Oct1_2021": 400.25
},
"IRSPaymentType": "EFTPS",
"IRSPayment": {
"BankRoutingNum": null,
"AccountType": null,
"BankAccountNum": null,
"Phone": null
},
"DepositScheduleType": {
"DepositorType": "MONTHLY",
"MonthlyDepositor": {
"TaxLiabilityMonth1": 10000,
"TaxLiabilityMonth2": 10000,
"TaxLiabilityMonth3": 4372.45
},
"SemiWeeklyDepositor": null,
"TotalQuarterTaxLiabilityAmt": 24372.45
}
},
"RecordId": null
}
],
"SubmissionId": 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
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
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
Response JSON
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"ErrorRecords": null,
"Errors": null
}
1
2
3
4
5
6
7
2
3
4
5
6
7