Get
Use this method to retrieve the complete information reported on 941-X forms that are already created in TaxBandits. The request JSON can include the Submission Id and RecordIds.
GET Form941X/Get 
Request Params
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission |
Request Params
"Form941X/Get?submissionId=f2fee2f8-74bf-4e1d-9239-399e76929475"
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. |
| Form941XRecords | object[] | Object to create 941-Xs |
| 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, FORM941SS.Allowed values |
| TaxYr | string | The Tax year for which Form 941 needs to be filed. Allowed values: "2024","2025" |
| Qtr | string | The Quarter for which Form 941 needs to be filed. Allowed values |
| Business | object | Business Details |
| BusinessId | Guid | OptionalUse the unique Business ID (Generated by TaxBandits), you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again. |
| BusinessNm | string | Name of the business Size Range: ..75 |
| PayerRef | string | Optional An unique identifier for each payer completing their information. This identifier can be used in future references of the payer in the API. Size Range: ..50 |
| TradeNm | string | Optional Name under which the business operates Size Range: ..75 |
| IsEIN | Boolean | When true, identifies the business with an EIN. |
| EINorSSN | string | When IsEIN is true, use Employer Identification Number (EIN). When IsEIN is false, use Social Security Number (SSN). Size Range: 9-11 |
| string | Email address of the Business Size Range: ..100 | |
| ContactNm | string | Name of the person who can be contacted by the IRS Size Range: ..27 |
| Phone | string | Contact number of the business with area code Size Range: 10 |
| PhoneExtn | string | Optional Extension of the business phone number Size Range: ..5 |
| Fax | string | Optional Fax number of the Business Size Range: 10 |
| BusinessType | string | Type of business. Optional for W-2/1099 and mandatory for 94X series Size Range: ..4 Allowed values |
| 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 |
| KindOfEmployer | string | Identifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series.Allowed values |
| KindOfPayer | string | Kind Of Payer based on the Employer's Federal Tax Return.Allowed values |
| IsBusinessTerminated | Boolean | When true, identifies the business as terminated. |
| IsForeign | Boolean | When true, identifies the business address with a foreign address. |
| USAddress | object | if IsForeign is false, pass US address of the business |
| Address1 | string | Employer/Payer's US address (street address or post office box of that locality) Size Range: ..46 |
| Address2 | string | Optional Employer/Payer's suite or apartment Size Range: ..46 |
| City | string | Employer/Payer's city Size Range: ..50 |
| State | string | Employer/Payer's state Size Range: 2 Allowed values |
| ZipCd | string | Employer/Payer's zip code. Size Range: 5..10 |
| ForeignAddress | object | if IsForeign is true, pass foreign address of the business |
| Address1 | string | Employer/Payer's foreign address (street address or post office box of that locality). Size Range: ..50 |
| Address2 | string | Optional Employer/Payer's suite or apartment Size Range: ..50 |
| City | string | Employer/Payer's city Size Range: ..50 |
| ProvinceOrStateNm | string | Employer/Payer's province or state name Size Range: ..50 |
| Country | string | Employer/Payer's country Size Range: 2 Allowed values |
| PostalCd | string | Employer/Payer's postal code Size Range: ..16 |
| IsThirdPartyDesignee | Boolean | When true, your third-party designee is allowed to discuss the return with the IRS. |
| ThirdPartyDesignee | object | Third Party Designee Details |
| Name | string | Third Party Designee's name. |
| Phone | string | Third Party Designee's phone number |
| PIN | string | A 5 digit PIN (Should not contain all zeroes) used when communicating to the IRS |
| SignatureDetails | object | Identifies the signature type used in Form 941 |
| SignatureType | string | Type of signature used to sign Form 941Allowed values |
| 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 |
| TaxPayerPIN | object | Use this option if you have selected ERO under SignatureType.. |
| PIN | string | Any 5-digit PIN given by the Taxpayer on Form 8879-EMP Part II "Taxpayer Declaration and Signature Authorization". Size Range: 5 |
| Form8453EMP | object | An alternate option to sign the return using Form 8453 EMP when there is no PIN |
| BusinessStatusDetails | object | Identifies the status of the Business |
| IsBusinessClosed | Boolean | When true, identifies the business as terminated or stopped paying wages |
| BusinessClosedDetails | object | Identifies the Record Keeper details and date on which the Business was closed |
| Name | string | Name of the Record Keeper Size Range: ..75 |
| FinalDateWagesPaid | DateTime | Final date on which the business last paid the wages |
| IsForeign | Boolean | When true, identifies if the business has a foreign address. |
| USAddress | object | if IsForeign is false, pass US address of the business |
| Address1 | string | Employer/Payer's US address (street address or post office box of that locality) Size Range: ..46 |
| Address2 | string | Optional Employer/Payer's suite or apartment Size Range: ..46 |
| City | string | Employer/Payer's city Size Range: ..50 |
| State | string | Employer/Payer's state Size Range: 2 Allowed values |
| ZipCd | string | Employer/Payer's zip code. Size Range: 5..10 |
| ForeignAddress | object | if IsForeign is true, pass foreign address of the business |
| Address1 | string | Employer/Payer's foreign address (street address or post office box of that locality) Size Range: ..50 |
| Address2 | string | Optional Employer/Payer's suite or apartment Size Range: ..50 |
| City | string | Employer/Payer's city Size Range: ..50 |
| ProvinceOrStateNm | string | Employer/Payer's province or state name Size Range: ..50 |
| Country | string | Employer/Payer's country Size Range: 2 Allowed values |
| PostalCd | string | Employer/Payer's postal code Size Range: ..16 |
| IsBusinessTransferred | Boolean | When true, identifies the business as transferred. |
| BusinessTransferredDetails | object | Type of Transfer and Record Keeper details |
| Name | string | Name of the Record Keeper |
| BusinessChangeType | string | Type of Transfer.Allowed values |
| DateOfChange | DateTime | Date of Sale / Transfer |
| NewBusinessType | string | New Business Type of the transferred businessAllowed values |
| NewBusinessName | string | New Business Name of the transferred business |
| IsForeign | Boolean | When true, identifies if the business has a foreign address. |
| USAddress | object | if IsForeign is false, pass US address of the business |
| Address1 | string | Employer/Payer's US address (street address or post office box of that locality) Size Range: ..46 |
| Address2 | string | Optional Employer/Payer's suite or apartment Size Range: ..46 |
| City | string | Employer/Payer's city Size Range: ..50 |
| State | string | State code of the employer/payer. Refer Static values. Size Range: 2 Allowed values |
| ZipCd | string | Employer/Payer's zip code. Size Range: 5..10 |
| ForeignAddress | object | if IsForeign is true, pass foreign address of the business |
| Address1 | string | Employer/Payer's foreign address (street address or post office box of that locality) Size Range: ..50 |
| Address2 | string | Optional Employer/Payer's suite or apartment Size Range: ..50 |
| City | string | Employer/Payer's city Size Range: ..50 |
| ProvinceOrStateNm | string | Employer/Payer's province or state name. Size Range: ..50 |
| Country | string | Employer/Payer country code. Refer Static values. Size Range: 2 Allowed values |
| PostalCd | string | Employer/Payer's postal code. Size Range: ..16 |
| ReturnData | object | Identifies the Form 941-X data |
| Form941X | object | Form 941-X, Adjusted Employer’s QUARTERLY Federal Tax Return or Claim for Refund |
| TypeOfError | string | Gets the type of error to be corrected. Allowed values |
| Certifications | object | Certifications on Form W-2 filing status, Adjustments and Claims declarations |
| Is3FiledW2W2c | Boolean | When true, identifies that the Form W-2 has been already filed or will be filed by the employer |
| Is4aRpdOrReimb | Boolean | When true, identifies that the employer has reimbursed for overcollected federal income tax, Additional Medicare Tax, social security tax, and Medicare tax for the current year and prior years, but has not claimed or rejected any refunds or credits. |
| Is4bAdjEmplShr | Boolean | When true, identifies that the adjustment of social security and Medicare tax is for the employer's share, but affected employees have not claimed or declined refunds or credits. |
| Is4cAdjNotWth | Boolean | When true, identifies that the adjustment pertains to unwithheld federal income tax, social security tax, Medicare tax, or Additional Medicare Tax from employee wages. |
| Is5aRpdReimb | Boolean | When true, identifies that the employer reimbursed affected employees for overcollected social security and Medicare taxes, but they declined to claim refunds or credits for prior years' claims. |
| Is5bWrttnCnsnt | Boolean | When true, identifies that the employer has written consent from affected employees to file a claim for social security and Medicare tax, but has also received a statement stating they have not claimed or rejected the claim. |
| Is5cClmEmplShr | Boolean | When true, identifies that the claim for social security and Medicare tax is for the employer's share, but affected employees have not provided written consent or statements stating they haven't claimed or rejected the claim. |
| Is5dClmNotWth | Boolean | When true, identifies that the claim pertains to unwithheld federal income tax, social security tax, Medicare tax, or Additional Medicare Tax from employee wages. |
| TotalCorrectionAmt | object | Identifies total corrected amount (column1) |
| WagesAmt | Decimal | Gets the amount of wages, tips, and other compensation. Form 941, line 2 Size Range: 0-9999999999999999999.99 |
| FedIncomeTaxWHAmt | Decimal | Gets the amount of federal income tax withheld from wages, tips, and other compensation. Form 941, line 3 Size Range: 0-9999999999999999999.99 |
| SocialSecurityTaxCashWagesAmt | Decimal | Gets the taxable social security wages amount. Form 941 or 941-SS, line 5a, Column 1. Size Range: 0-9999999999999999999.99 |
| TaxableSocSecTipsAmt | Decimal | Gets the taxable social security tips amount. Form 941 or 941-SS, line 5b, Column 1. Size Range: 0-9999999999999999999.99 |
| TaxableMedicareWagesTipsAmt | Decimal | Gets the taxable medicare wages and tips amount. Form 941 or 941-SS, line 5c, Column 1. Size Range: 0-9999999999999999999.99 |
| TxblWageTipsSubjAddnlMedcrAmt | Decimal | Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Form 941 or 941-SS, line 5d. Size Range: 0-9999999999999999999.99 |
| TaxOnUnreportedTips3121qAmt | Decimal | Gets the tax due from Section 3121(q) Notice and Demand on Form 941 or 941-SS, line 5f. Size Range: 0-9999999999999999999.99 |
| TaxAdjustmentAmt | Decimal | Gets the combined value of lines 7, 8 and 9 of Form 941 or 941-SS. Size Range: 0-9999999999999999999.99 |
| PayrollTaxCreditAmt | Decimal | Gets the amount of qualified small business payroll tax credit for increasing research activities. Form 941 line 11 or 941-SS line 11a. Size Range: 0-99999999999999.99 |
| Form8974 | object | Information of Form 8974 |
| Form8974IncomeTaxDetails | object[] | Collection of Income Tax details |
| IncomeTaxPeriodEndDate | string | Gets the ending date of income tax period in Part 1 Column (a). |
| IncomeTaxReturnFiledForm | string | Gets the Income tax return filed to elected a qualified small business payroll tax credit on Form 6765. Form 6765 can be attached to Form 1040, 1065, 1120, 1120-F, or 1120S. Part 1 Column (b) |
| IncomeTaxReturnFiledDate | string | Gets the income tax return filing date shown in column (b). Part 1 Column (c) |
| Form6765EIN | string | Gets the EIN used on Form 6765 if the EIN used on Form 8974 doesn't match with the EIN on Form 6765. Part 1 Column (d) Size Range: 9 |
| Form6765Line44Amt | Decimal | 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 | Decimal | Gets the amount of credit from column (e) taken on a previous period(s). Part 1 Column (f) Size Range: 0-99999999999999.99 |
| RemainingCredit | Decimal | 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 |
| Line12 | Decimal | Enter the smaller of Form 8974, line 7 or 11, but not more than $250,000 per quarter. Size Range: 0-99999999999999.99 |
| Line13 | Decimal | Subtract Form 8974, line 12 from line 7. Enter the result on line 13. Size Range: 0-99999999999999.99 |
| Line14 | Decimal | Enter the amount from Form 941, line 5c, column 2. This is the total amount of Medicare tax on wages. Size Range: 0-99999999999999.99 |
| Line15 | Decimal | Enter Form 8974, line 14 multiplied by 50% (0.50) on line 15. Size Range: 0-99999999999999.99 |
| Line16 | Decimal | Enter the smaller of line 13 or 15. This is the total credit against the employer share of Medicare tax. Size Range: 0-99999999999999.99 |
| Line17 | Decimal | Add lines 12 and 16. Also, enter this amount on Form 941, line 11a. Size Range: 0-99999999999999.99 |
| SplAddnlWagesFedIncomeTaxAmt | Decimal | Gets the special addition to wages for federal income tax. Size Range: 0-99999999999999.99 |
| SplAddnlWagesSocialSecurityTaxAmt | Decimal | Gets the special addition to wages for social security taxes. Size Range: 0-99999999999999.99 |
| SplAddnlWagesMedcrTaxAmt | Decimal | Gets the special addition to wages for medicare taxes. Size Range: 0-99999999999999.99 |
| SplAddnlWagesAddnlMedcrTaxAmt | Decimal | Gets the special addition to wages for additional medicare tax. Size Range: 0-99999999999999.99 |
| OriginallyReportedOrPrevCorrection | object | Identifies amount originally reported or as previously corrected (column2) |
| WagesAmt | Decimal | Gets the originally reported amount of wages, tips, and other compensation. Form 941, line 2 Size Range: 0-9999999999999999999.99 |
| FedIncomeTaxWHAmt | Decimal | Gets the originally reported amount of federal income tax withheld from wages, tips, and other compensation. Form 941, line 3 Size Range: 0-9999999999999999999.99 |
| SocialSecurityTaxCashWagesAmt | Decimal | Gets the originally reported taxable social security wages amount. Form 941 or 941-SS, line 5a, Column 1. Size Range: 0-9999999999999999999.99 |
| TaxableSocSecTipsAmt | Decimal | Gets the originally reported taxable social security tips amount. Form 941 or 941-SS, line 5b, Column 1. Size Range: 0-9999999999999999999.99 |
| TaxableMedicareWagesTipsAmt | Decimal | Gets the originally reported taxable medicare wages and tips amount. Form 941 or 941-SS, line 5c, Column 1. Size Range: 0-9999999999999999999.99 |
| TxblWageTipsSubjAddnlMedcrAmt | Decimal | Gets the originally reported taxable wages and tips subject to additional Medicare Tax withholding amount. Form 941 or 941-SS, line 5d. Size Range: 0-9999999999999999999.99 |
| TaxOnUnreportedTips3121qAmt | Decimal | Gets the originally reported tax due from Section 3121(q) Notice and Demand on Form 941 or 941-SS, line 5f. Size Range: 0-9999999999999999999.99 |
| TaxAdjustmentAmt | Decimal | Gets the originally reported combined value of lines 7, 8 and 9 of Form 941 or 941-SS. Size Range: 0-9999999999999999999.99 |
| PayrollTaxCreditAmt | Decimal | Gets the originally reported amount of qualified small business payroll tax credit for increasing research activities. Form 941 line 11 or 941-SS line 11a. Size Range: 0-99999999999999.99 |
| SplAddnlWagesFedIncomeTaxAmt | Decimal | Gets the originally reported special addition to wages for federal income tax. Size Range: 0-99999999999999.99 |
| SplAddnlWagesSocialSecurityTaxAmt | Decimal | Gets the originally reported special addition to wages for social security taxes. Size Range: 0-99999999999999.99 |
| SplAddnlWagesMedcrTaxAmt | Decimal | Gets the originally reported special addition to wages for medicare taxes. Size Range: 0-99999999999999.99 |
| SplAddnlWagesAddnlMedcrTaxAmt | Decimal | Gets the originally reported special addition to wages for additional medicare tax. Size Range: 0-99999999999999.99 |
| CorrectionReportedDifference | object | Identifies the difference between total corrected amount (column 1) and amount originally reported or as previously corrected (column2). |
| WagesAmt | Decimal | Gets the amount of wages, tips, and other compensation. Form 941, line 2. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| FedIncomeTaxWHAmt | Decimal | Gets the amount of federal income tax withheld from wages, tips, and other compensation. Form 941, line 3 Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| SocialSecurityTaxCashWagesAmt | Decimal | Gets the taxable social security wages amount. Form 941 or 941-SS, line 5a, Column 1. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| TaxableSocSecTipsAmt | Decimal | Gets the taxable social security tips amount. Form 941 or 941-SS, line 5b, Column 1. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| TaxableMedicareWagesTipsAmt | Decimal | Gets the taxable medicare wages and tips amount. Form 941 or 941-SS, line 5c, Column 1. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| TxblWageTipsSubjAddnlMedcrAmt | Decimal | Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Form 941 or 941-SS, line 5d. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| TaxOnUnreportedTips3121qAmt | Decimal | Gets the tax due from Section 3121(q) Notice and Demand on Form 941 or 941-SS, line 5f. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| TaxAdjustmentAmt | Decimal | Gets the combined value of lines 7, 8 and 9 of Form 941 or 941-SS. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| PayrollTaxCreditAmt | Decimal | Gets the amount of qualified small business payroll tax credit for increasing research activities. Form 941 line 11 or 941-SS line 11a. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| SplAddnlWagesFedIncomeTaxAmt | Decimal | Gets the special addition to wages for federal income tax. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| SplAddnlWagesSocialSecurityTaxAmt | Decimal | Gets the special addition to wages for social security taxes. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| SplAddnlWagesMedcrTaxAmt | Decimal | Gets the special addition to wages for medicare taxes. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| SplAddnlWagesAddnlMedcrTaxAmt | Decimal | Gets the special addition to wages for additional medicare tax. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If this amount is a negative number, use a minus sign |
| TaxCorrection | object | Identifies the tax corrected amounts (column 4) |
| FedIncomeTaxWHAmt | Decimal | Gets the corrected amount of federal income tax withheld from wages, tips, and other compensation. Form 941, line 3 Size Range: -9999999999999999999.99-9999999999999999999.99 |
| SocialSecurityTaxCashWagesAmt | Decimal | Gets the corrected taxable social security wages amount. Form 941 or 941-SS, line 5a, Column 1. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If you're correcting your employer share only use 0.062 to calculate the corrected taxable social security wages amount else use 0.124 |
| TaxableSocSecTipsAmt | Decimal | Gets the corrected taxable social security tips amount. Form 941 or 941-SS, line 5b, Column 1. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If you're correcting your employer share only use 0.062 to calculate the corrected taxable social security wages amount else use 0.124 |
| TaxableMedicareWagesTipsAmt | Decimal | Gets the corrected taxable medicare wages and tips amount. Form 941 or 941-SS, line 5c, Column 1. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If you're correcting your employer share only use 0.0145 to calculate the corrected taxable social security wages amount else use 0.029 |
| TxblWageTipsSubjAddnlMedcrAmt | Decimal | Gets the corrected taxable wages and tips subject to additional Medicare Tax withholding amount. Form 941 or 941-SS, line 5d. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: Certain wages and tips reported in CorrectionReportedDifference shouldn’t be multiplied by 0.009. Refer |
| TaxOnUnreportedTips3121qAmt | Decimal | Gets the corrected tax due from Section 3121(q) Notice and Demand on Form 941 or 941-SS, line 5f. Size Range: -9999999999999999999.99-9999999999999999999.99 |
| TaxAdjustmentAmt | Decimal | Gets the corrected combined value of lines 7, 8 and 9 of Form 941 or 941-SS. Size Range: -9999999999999999999.99-9999999999999999999.99 |
| PayrollTaxCreditAmt | Decimal | Gets the corrected amount of qualified small business payroll tax credit for increasing research activities. Form 941 line 11 or 941-SS line 11a. Size Range: -9999999999999999999.99-9999999999999999999.99 |
| SplAddnlWagesFedIncomeTaxAmt | Decimal | Gets the corrected special addition to wages for federal income tax. Size Range: -9999999999999999999.99-9999999999999999999.99 |
| SplAddnlWagesSocialSecurityTaxAmt | Decimal | Gets the corrected special addition to wages for social security taxes. Size Range: -9999999999999999999.99-9999999999999999999.99 |
| SplAddnlWagesMedcrTaxAmt | Decimal | Gets the corrected special addition to wages for medicare taxes. Size Range: -9999999999999999999.99-9999999999999999999.99 |
| SplAddnlWagesAddnlMedcrTaxAmt | Decimal | Gets the corrected special addition to wages for additional medicare tax. Size Range: -9999999999999999999.99-9999999999999999999.99 |
| CombinedTaxAmt | Decimal | Gets the combined total of TaxCorrection object Size Range: -9999999999999999999.99-9999999999999999999.99 |
| TotalAmt | Decimal | Gets the total tax amount. Size Range: -9999999999999999999.99-9999999999999999999.99 Note: If TotalAmt is greater than zero then IRSPayment and AmndScheduleB is required |
| IsCorrectionUndrReportedOvrReporteddAmt | Boolean | If true identifies that corrections reported include both underreported and overreported amounts |
| IsCorrectionReclassWrks | Boolean | If true identifies that corrections involve reclassified workers |
| CorrectionExpln | string | Gets the detailed explanation of corrections are determined Size Range: 10000 |
| IRSPaymentType | string | Payment type to make payments to the IRS. Choose from EFW, EFTPS, Check or Money OrderAllowed values |
| 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 |
| BankAccountNum | string | Bank Account Number of EFW payment Size Range: ..17 |
| Phone | string | Phone of EFW payment Size Range: 10 |
| AmndScheduleB | object | Deposit schedule of the amount to be reported to IRS |
| ScheduleBMonth1Amt | object[] | Tax Liability for Month 1 of the filing quarter in Form Schedule B. |
| Day | string | Tax Liability Day of the month. Allowed values |
| Amt | Decimal | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| ScheduleBMonth2Amt | object[] | Tax Liability for Month 2 of the filing quarter in Form Schedule B. |
| Day | string | Tax Liability Day of the month. Allowed values |
| Amt | Decimal | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| ScheduleBMonth3Amt | object[] | Tax Liability for Month 3 of the filing quarter in Form Schedule B. |
| Day | string | Tax Liability Day of the month. Allowed values |
| Amt | Decimal | Tax Liability Amount. Size Range: 0-99999999999999.99 |
| TotalQuarterTaxLiabilityAmt | Decimal | Total tax liability amount for the quarter. Size Range: 0-99999999999999.99 Note: TotalQuarterTaxLiabilityAmt should be equal to TotalAmt only if TotalAmt is greater than zero |
| Errors | object[] | Shows detailed error information |
| Id | string | Returns the validation error id. |
| Name | string | Name of the validation error. |
| Message | string | Description of the validation error. |
Response JSON
Success Response - This is a sample response for successful API requests.
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "7c1f1df2-61f1-4881-88d5-2a5db230e987",
"Form941XRecords": [
{
"RecordId": "9ae8badc-d68e-4913-a050-fae80d0a9acd",
"SequenceId": "002",
"RecordStatus": "CREATED",
"ReturnHeader": {
"ReturnType": "Form941x",
"MoreClients": false,
"TaxYr": "2024",
"Qtr": "Q2",
"ErrorsDisDate": "08/01/2024",
"Business": {
"BusinessId": "47e6f5ea-f9b9-49ae-bf4a-ef945da053be",
"PayerRef": null,
"BusinessNm": "SnowDaze LLC",
"FirstNm": null,
"MiddleNm": null,
"LastNm": null,
"Suffix": null,
"TradeNm": "Icecreams",
"IsEIN": true,
"EINorSSN": "00-2356895",
"Email": "joel@sample.com",
"ContactNm": "Joel Cruz",
"Phone": "7876417809",
"PhoneExtn": "12345",
"Fax": null,
"BusinessType": "CORP",
"SigningAuthority": {
"Name": "Joel Cruz",
"Phone": "(787) 641-7809",
"BusinessMemberType": "TAXOFFICER"
},
"KindOfEmployer": null,
"KindOfPayer": null,
"IsBusinessTerminated": false,
"IsForeign": false,
"USAddress": {
"Address1": "71 st nicholas drive",
"Address2": null,
"City": "Northpole",
"State": "AK",
"ZipCd": "99705"
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
},
"ACADetails": null
},
"IsThirdPartyDesignee": false,
"ThirdPartyDesignee": null,
"SignatureDetails": {
"SignatureType": "ONLINE_SIGN_PIN",
"OnlineSignaturePIN": {
"PIN": "2136558945"
},
"ReportingAgentPIN": null,
"TaxPayerPIN": null,
"Form8453EMP": null
},
"BusinessStatusDetails": null
},
"ReturnData": {
"Form941x": {
"TypeOfError": "ADJUSTED",
"Certifications": {
"Is3FiledW2W2c": true,
"Is4aRpdOrReimb": true,
"Is4bAdjEmplShr": true,
"Is4cAdjNotWth": false,
"Is5aRpdReimb": false,
"Is5bWrttnCnsnt": false,
"Is5cClmEmplShr": false,
"Is5dClmNotWth": false
},
"TotalCorrectionAmt": {
"WagesAmt": "3000.00",
"FedIncomeTaxWHAmt": "3000.00",
"SocialSecurityTaxCashWagesAmt": "1798.29",
"TaxableSocSecTipsAmt": "176.12",
"TaxableMedicareWagesTipsAmt": "333.87",
"TxblWageTipsSubjAddnlMedcrAmt": "3500.00",
"TaxOnUnreportedTips3121qAmt": "5000.00",
"TaxAdjustmentAmt": "3000.00",
"PayrollTaxCreditAmt": "1154.15",
"SplAddnlWagesFedIncomeTaxAmt": "1000.00",
"SplAddnlWagesSocialSecurityTaxAmt": "1500.00",
"SplAddnlWagesMedcrTaxAmt": "2300.00",
"SplAddnlWagesAddnlMedcrTaxAmt": "1700.00",
"Form8974": {
"Form8974IncomeTaxDetails": [
{
"IncomeTaxPeriodEndDate": "07/07/2022",
"IncomeTaxReturnFiledForm": "FORM1065",
"IncomeTaxReturnFiledDate": "07/07/2022",
"Form6765EIN": "00-6548957",
"Form6765Line44Amt": 5000.00,
"PreviousPeriodRemainingCreditAmt": 100.00,
"RemainingCredit": 4900.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": 4900.00,
"Line8": 1798.29,
"Line9": 176.12,
"Line10": 1974.41,
"Line11": 987.21,
"PayerIndicatorType": "SECTION3121QIND",
"Line12": 987.21,
"Line13": 3912.79,
"Line14": 333.87,
"Line15": 166.94,
"Line16": 166.94,
"Line17": 1154.15
}
},
"OriginallyReportedOrPrevCorrection": {
"WagesAmt": "3050.00",
"FedIncomeTaxWHAmt": "2000.00",
"SocialSecurityTaxCashWagesAmt": "798.29",
"TaxableSocSecTipsAmt": "76.12",
"TaxableMedicareWagesTipsAmt": "33.87",
"TxblWageTipsSubjAddnlMedcrAmt": "1500.00",
"TaxOnUnreportedTips3121qAmt": "4000.00",
"TaxAdjustmentAmt": "2000.00",
"PayrollTaxCreditAmt": "154.15",
"SplAddnlWagesFedIncomeTaxAmt": "500.00",
"SplAddnlWagesSocialSecurityTaxAmt": "1000.00",
"SplAddnlWagesMedcrTaxAmt": "300.00",
"SplAddnlWagesAddnlMedcrTaxAmt": "700.00"
},
"CorrectionReportedDifference": {
"WagesAmt": "-50.00",
"FedIncomeTaxWHAmt": "1000.00",
"SocialSecurityTaxCashWagesAmt": "1000.00",
"TaxableSocSecTipsAmt": "100.00",
"TaxableMedicareWagesTipsAmt": "300.00",
"TxblWageTipsSubjAddnlMedcrAmt": "2000.00",
"TaxOnUnreportedTips3121qAmt": "1000.00",
"TaxAdjustmentAmt": "1000.00",
"PayrollTaxCreditAmt": "1000.00",
"SplAddnlWagesFedIncomeTaxAmt": "500.00",
"SplAddnlWagesSocialSecurityTaxAmt": "500.00",
"SplAddnlWagesMedcrTaxAmt": "2000.00",
"SplAddnlWagesAddnlMedcrTaxAmt": "1000.00"
},
"TaxCorrection": {
"FedIncomeTaxWHAmt": "1000.00",
"SocialSecurityTaxCashWagesAmt": "62.00",
"TaxableSocSecTipsAmt": "6.20",
"TaxableMedicareWagesTipsAmt": "4.35",
"TxblWageTipsSubjAddnlMedcrAmt": "3500.00",
"TaxOnUnreportedTips3121qAmt": "1000.00",
"TaxAdjustmentAmt": "1000.00",
"PayrollTaxCreditAmt": "-1000.00",
"SplAddnlWagesFedIncomeTaxAmt": "7.50",
"SplAddnlWagesSocialSecurityTaxAmt": "37.20",
"SplAddnlWagesMedcrTaxAmt": "34.80",
"SplAddnlWagesAddnlMedcrTaxAmt": "1.80"
},
"CombinedTaxAmt": "5653.85",
"TotalAmt": "5653.85",
"IsCorrectionUndrReportedOvrReporteddAmt": false,
"IsCorrectionReclassWrks": false,
"CorrectionExpln": "The adjustments are solely for the employer's share of social security and Medicare taxes because either the affected employees could not be located or they did not provide written statements confirming they haven't and won't claim a refund or credit for the overcollection"
},
"IRSPaymentType": "EFTPS",
"IRSPayment": null,
"AmndScheduleB": {
"ScheduleBMonth1Amt": [
{
"Day": 1,
"Amt": 200000.00
},
{
"Day": 15,
"Amt": 87462.52
}
],
"ScheduleBMonth2Amt": null,
"ScheduleBMonth3Amt": null,
"TotalQuarterTaxLiabilityAmt": "287462.52"
}
},
"ReturnNumber": "6Q002602460658-40"
}
],
"Errors": null
}