Get
Gets information of 943 returns by Submission Id.
GET Form943/Get
Request Body
| Field | Type | Description |
|---|---|---|
| SubmissionId | Guid | Unique identifier of a submission |
| RecordIds | string | Optional Gets the list of Record IDs |
Response Parameters
| Field | Type | Description |
|---|---|---|
| StatusCode | number | Returns the HTTP status codes like 200,300 etc. |
| StatusName | string | Name of the status code. |
| StatusMessage | string | Detailed status message. |
| SubmissionId | Guid | Unique identifier of a submission |
| Form943Records | object[] | Employer's Form 943 information. |
| RecordId | Guid | Unique identifier of a record |
| ReturnHeader | object | Identifies the supporting details of Form 943. |
| ReturnType | string | Type of the return filed. |
| TaxYr | string | The Tax year for which Form 943 has been filed. |
| Business | object | Business Details |
| BusinessNm | string | Name of the business |
| TradeNm | string | Optional Name under which the business operates |
| IsEIN | Boolean | When true, identifies the business with an EIN. |
| EINorSSN | string | Employer Identification Number (EIN). When IsEIN is false, Social Security Number (SSN). |
| string | Email address of the Business | |
| ContactNm | string | Name of the person who can be contacted by the IRS |
| Phone | string | Contact number of the business with area code |
| PhoneExtn | string | Optional Extension of the business phone number |
| Fax | string | Optional Fax number of the Business |
| BusinessType | string | Type of business. |
| SigningAuthority | object | Details of the person who is authorized to sign the return |
| Name | string | Name of the signing authority. |
| Phone | string | Phone number of the signing authority. |
| BusinessMemberType | string | Business title of the signing authority |
| KindOfEmployer | string | Identifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series. |
| KindOfPayer | string | Kind Of Payer based on the Employer's Federal Tax Return. |
| IsBusinessTerminated | Boolean | When true, identifies the business as terminated. |
| IsForeign | Boolean | When true, identifies the business address with a foreign address. |
| USAddress | object | if IsForeign is false, US address of the business |
| Address1 | string | Employer/Payer's US address (street address or post office box of that locality) |
| Address2 | string | Optional Employer/Payer's suite or apartment |
| City | string | Employer/Payer's city |
| State | string | Employer/Payer's state |
| ZipCd | string | Employer/Payer's zip code |
| ForeignAddress | object | if IsForeign is true, pass foreign address of the business |
| Address1 | string | Employer/Payer's foreign address (street address or post office box of that locality). |
| Address2 | string | Optional Employer/Payer's suite or apartment |
| City | string | Employer/Payer's city |
| ProvinceOrStateNm | string | Employer/Payer's province or state name |
| Country | string | Employer/Payer's country |
| PostalCd | string | Employer/Payer's postal code |
| IsThirdPartyDesignee | Boolean | When true, your third-party designee is allowed to discuss the return with the IRS. |
| ThirdPartyDesignee | object | Third Party Designee Details |
| Name | string | Third Party Designee's name. |
| Phone | string | Third Party Designee's phone number |
| PIN | string | A 5 digit PIN (Should not contain all zeroes) used when communicating to the IRS |
| SignatureDetails | object | Identifies the signature type used in Form 943 |
| SignatureType | string | Type of signature used to sign Form 943 |
| OnlineSignaturePIN | object | A 10-digit signature PIN to become an IRS authorized signer. |
| PIN | string | Sign using a 10 digit PIN received from the IRS. |
| ReportingAgentPIN | object | A 5-digit number assigned by the IRS |
| PIN | string | Sign using a 5 digit PIN received from the IRS. |
| Form8453EMP | object | An alternate option to sign the return using Form 8453 EMP when there is no PIN |
| AttachmentNm | string | Name of the Form 8453EMP attachment |
| Attachment | byte[] | Byte array of Form-8453 pdf |
| AttachmentFileType | string | Type of the file Attachment |
| SignedDate | DateTime | Date and time on which the Form 8453-EMP was signed |
| BusinessStatusDetails | object | Identifies the status of the Business |
| IsBusinessClosed | Boolean | When true, identifies the business as terminated or stopped paying wages |
| BusinessClosedDetails | object | Identifies the Record Keeper details and date on which the Buiness was closed |
| Name | string | Name of the Record Keeper |
| FinalDateWagesPaid | DateTime | Final date on which the business last paid the wages |
| IsForeign | Boolean | When true, identifies if the business has a foreign address. |
| USAddress | object | if IsForeign is false, pass US address of the business |
| Address1 | string | Employer/Payer's US address (street address or post office box of that locality) |
| Address2 | string | Optional Employer/Payer's suite or apartment |
| City | string | Employer/Payer's city |
| State | string | Employer/Payer's state |
| ZipCd | string | Employer/Payer's zip code |
| ForeignAddress | object | if IsForeign is true, pass foreign address of the business |
| Address1 | string | Employer/Payer's foreign address (street address or post office box of that locality) |
| Address2 | string | Optional Employer/Payer's suite or apartment |
| City | string | Employer/Payer's city |
| ProvinceOrStateNm | string | Employer/Payer's province or state name |
| Country | string | Employer/Payer's country |
| PostalCd | string | Employer/Payer's postal code |
| ReturnData | object | Identifies the Form 943 data |
| Form943 | object | Form 943, Employer’s QUARTERLY Federal Tax Return |
| PriorAddressInd | Boolean | When true, If address is different from prior return. |
| EmployeeCnt | number | Gets the number of Employees who has received wages, tips, or other compensation for the pay period. Line 1 |
| SocialSecurityTaxCashWagesAmt_Col1 | number | Gets the taxable social security wages amount. Line 2 |
| SocialSecurityTaxAmt | number | Gets the taxable social security tips amount. Line 3 |
| MedicareTaxCashWagesAmt | number | Gets the taxable medicare wages and tips amount. Line 4 |
| MedicareTaxWithheldAmt | number | Gets the taxable medicare withheld amount. Line 5 |
| TotMedcrTaxCashWagesAddnlWhAmt | number | Gets the taxable wages and tips subject to additional Medicare Tax withholding amount. Line 6 |
| AddnlMedicareTaxWithholdingAmt | number | Gets additional Medicare Tax withholding amount. Line 7 |
| FederalIncomeTaxWithheldAmt | number | Gets the tax on Federal Income Tax withheld. Line 8 |
| TotalTaxBeforeAdjustmentAmt | number | Gets the total taxes beofre adjustments by adding lines 3, 5,7 and 8. Line 9 |
| CurrentYearAdjustmentAmt | number | Gets the tax on current year's adjustments. Line 10 |
| TotalTaxAfterAdjustmentAmt | number | Gets the Total taxes Security after adding adjustments by line 9 adjusted by line 10. Line 11 |
| PayrollTaxCreditAmt | number | Gets the tax for qualified small business payroll tax credits.line 12 |
| TotalTaxAmt | number | Gets the Total taxes after adjustments and credits by subtracting line 12 from line 11.Line 13. |
| TotalTaxDepositAmt | number | Gets the amount of total tax deposits including overpayment applied from prior year and Form 943-x. Line 14. |
| BalanceDueAmt | number | Gets the amount of difference between line 13 and line 14, if line 13 is greater than line 14. Line 15. |
| OverpaidAmt | number | Gets the amount difference between line 14 and line 13, if line 14 is greater than line 13. Line 16. |
| IsOverPayment | Boolean | When true, identifies the Line 12 is greater than zero to determine the amount of qualified small business payroll tax credit for increasing research activities that a business can claim on Form 943. |
| Form8974 | object | Information of Form 8974 |
| Form8974IncomeTaxDetails | object[] | Collection of Income Tax details |
| IncomeTaxPeriodEndDate | string | Gets the ending date of income tax period in Part 1 Column (a). |
| IncomeTaxReturnFiledForm | string | Gets the Income tax return filed to elected a qualified small business payroll tax credit on Form 6765. Form 6765 can be attached to Form 1040, 1065, 1120, 1120_F, or 1120S. Part 1 Column (b) |
| IncomeTaxReturnFiledDate | string | Gets the income tax return filing date shown in column (b). Part 1 Column (c) |
| Form6765EIN | string | Gets the EIN used on Form 6765 if the EIN used on Form 8974 doesn't match with the EIN on Form 6765. Part 1 Column (d) |
| Form6765Line44Amt | number | Gets the amount from Form 6765, line 44 or the amount allocated to your EIN if applicable. Part 1 Column (e) |
| PreviousPeriodRemainingCreditAmt | number | Gets the amount of credit from column (e) taken on a previous period(s). Part 1 Column (f) |
| RemainingCredit | number | Gets the total amount of remaining credit by subtracting column (f) from column (e). Part 1 Column (g). |
| Line7 | number | Gets the total amount from Part 1, line 6(g). Part 2 Line 7. |
| Line8 | number | Gets the total amount of social security tax on wages from Form 943, line 5a, column 2; Form 943, line 3; or Form 944, line 4a, column 2. Part 2 Line 8. |
| Line9 | number | Gets the total amount of social security tax on tips from Form 943, line 5b, column 2; or Form 944, line 4b, column 2. Part 2 Line 9. |
| Line10 | number | Gets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10. |
| Line11 | number | Gets the amount of line 10 multiplied by 50% (0.50) on line 11. If you’re a third-party payer of sick pay or you received a Section 3121(q) Notice and Demand, check the applicable box on line 11. |
| PayerIndicatorType | string | Identifies if you are a Third-party payer of sick pay or received a Section 3121(q) Notice and Demand |
| Line12 | number | Gets the credit amount smaller of line 7 or line 11. Also, this amount entered on Form 943 (943-PR or 943-SS), line 11; Form 943 (943-PR), line 12; or Form 944 (944(SP)), line 8 |
| TotTaxDepositAmt | number | Gets the total deposits for the quarter, including overpayment amount applied from a prior quarter and overpayments applied by filing Form 943-X, 943-X(PR), 944-X, or 944-X(SP) filed in the current quarter. Line 13 |
| OverPaymentRecoveryType | string | Gets the overpayment recovery type, whether to have the IRS refund the excess amount or apply it to next return. Check only one box on line 15. |
| FilerType | string | Type of Form 943 filer |
| IRSPaymentType | string | EFW, EFTPS, Check or Money Order |
| IRSPayment | object | Identifies the details of Electronic Funds Withdrawal (EFW) if paying the balance due along with the return |
| BankRoutingNum | string | Bank Routing Number of EFW payment |
| AccountType | string | Account Type (Checking or Saving) of EFW payment |
| BankAccountNum | string | Bank Account Number of EFW payment |
| Phone | string | Phone of EFW payment |
| DepositScheduleType | object | Identifies the Employer's deposit schedule and tax liability for the quarter |
| DepositorType | string | Type of Deposit Schedule. Values like Monthly or Semi Weekly |
| MonthlyDepositor | object | Line 16, Option 2. Monthly Schedule Depositor |
| JanTaxLiability | number | Tax Liability for January. |
| FebTaxLiability | number | Tax Liability for Febraury. |
| MarTaxLiability | number | Tax Liability for March. |
| AprTaxLiability | number | Tax Liability for April. |
| MayTaxLiability | number | Tax Liability for May. |
| JunTaxLiability | number | Tax Liability for June. |
| JulTaxLiability | number | Tax Liability for July. |
| AugTaxLiability | number | Tax Liability for August. |
| SepTaxLiability | number | Tax Liability for September. |
| OctTaxLiability | number | Tax Liability for October. |
| NovTaxLiability | number | Tax Liability for November. |
| DecTaxLiability | number | Tax Liability for December. |
| TaxLiabilityTotalAmt | number | Total tax liability amount. |
| SemiWeeklyDepositor | object | Line 16, Option 3. SemiWeekly Depositor |
| Form943AJanMonthAmt | object[] | Tax Liability for January in Form 943 A. |
| Day | string | "Tax Liability Day of Jan month. Allowed values: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"" |
| Amt | number | "Tax Liability Amount of Jan month. Size Range: 0-99999999999999.99" |
| Form943AJanMonthTotAmt | number | "Total Tax Liability for January in Form 943 A. Size Range: 0-99999999999999.99" |
| Form943AFebMonthAmt | object[] | Tax Liability for February in Form 943 A. |
| Day | string | "Tax Liability Day of Feb month. Allowed values: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"" |
| Amt | number | "Tax Liability Amount of Feb month. Size Range: 0-99999999999999.99" |
| Form943AFebMonthTotAmt | number | "Total Tax Liability for February in Form 943 A. Size Range: 0-99999999999999.99" |
| Form943AMarMonthAmt | object[] | Tax Liability for March in Form 943 A. |
| Day | string | "Tax Liability Day of Mar month. Allowed values: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"" |
| Amt | number | "Tax Liability Amount of Mar month. Size Range: 0-99999999999999.99" |
| Form943AJMarMonthTotAmt | number | "Total Tax Liability for March in Form 943 A. Size Range: 0-99999999999999.99" |
| Form943AAprMonthAmt | object[] | Tax Liability for April in Form 943 A. |
| Day | string | "Tax Liability Day of Apr month. Allowed values: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"" |
| Amt | number | "Tax Liability Amount of Apr month. Size Range: 0-99999999999999.99" |
| Form943AAprMonthTotAmt | number | "Total Tax Liability for April in Form 943 A. Size Range: 0-99999999999999.99" |
| Form943AMayMonthAmt | object[] | Tax Liability for May in Form 943 A. |
| Day | string | "Tax Liability Day of May month. Allowed values: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"" |
| Amt | number | "Tax Liability Amount of May month. Size Range: 0-99999999999999.99" |
| Form943AMayMonthTotAmt | number | "Total Tax Liability for May in Form 943 A. Size Range: 0-99999999999999.99" |
| Form943AJunMonthAmt | object[] | Tax Liability for June in Form 943 A. |
| Day | string | "Tax Liability Day of Jun month. Allowed values: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"" |
| Amt | number | "Tax Liability Amount of Jun month. Size Range: 0-99999999999999.99" |
| Form943AJunMonthTotAmt | number | "Total Tax Liability for June in Form 943 A. Size Range: 0-99999999999999.99" |
| Form943AJulMonthAmt | object[] | Tax Liability for July in Form 943 A. |
| Day | string | "Tax Liability Day of Jul month. Allowed values: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"" |
| Amt | number | "Tax Liability Amount of Jul month. Size Range: 0-99999999999999.99" |
| Form943AJulMonthTotAmt | number | "Total Tax Liability for July in Form 943 A. Size Range: 0-99999999999999.99" |
| Form943AAugMonthAmt | object[] | Tax Liability for August in Form 943 A. |
| Day | string | "Tax Liability Day of Aug month. Allowed values: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"" |
| Amt | number | "Tax Liability Amount of Aug month. Size Range: 0-99999999999999.99" |
| Form943AAugMonthTotAmt | number | "Total Tax Liability for August in Form 943 A. Size Range: 0-99999999999999.99" |
| Form943ASepMonthAmt | object[] | Tax Liability for September in Form 943 A. |
| Day | string | "Tax Liability Day of Sep month. Allowed values: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"" |
| Amt | number | "Tax Liability Day of Sep month. Size Range: 0-99999999999999.99" |
| Form943ASepMonthTotAmt | number | "Total Tax Liability for September in Form 943 A. Size Range: 0-99999999999999.99" |
| Form943AOctMonthAmt | object[] | Tax Liability for October in Form 943 A. |
| Day | string | "Tax Liability Day of Oct month. Allowed values: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"" |
| Amt | number | "Tax Liability Amount of Oct month. Size Range: 0-99999999999999.99" |
| Form943AOctMonthTotAmt | number | "Total Tax Liability for October in Form 943 A. Size Range: 0-99999999999999.99" |
| Form943ANovMonthAmt | object[] | Tax Liability for November in Form 943 A. |
| Day | string | "Tax Liability Day of Nov month. Allowed values: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"" |
| Amt | number | "Tax Liability Amount of Nov month. Size Range: 0-99999999999999.99" |
| Form943ANovMonthTotAmt | number | "Total Tax Liability for November in Form 943 A. Size Range: 0-99999999999999.99" |
| Form943ADecMonthAmt | object[] | Tax Liability for December in Form 943 A. |
| Day | string | "Tax Liability Day of Dec month. Allowed values: "1", "2", "3", "4", "5", "6", "7", "8", "9", "10", "11", "12", "13", "14", "15", "16", "17", "18", "19", "20", "21", "22", "23", "24", "25", "26", "27", "28", "29", "30", "31"" |
| Amt | number | "Tax Liability Amount of Dec month. Size Range: 0-99999999999999.99" |
| Form943ADecMonthTotAmt | number | "Total Tax Liability for December in Form 943 A. Size Range: 0-99999999999999.99" |
| TotalTaxLiabilityWholeYearAmt | number | "Total tax liability amount Size Range: 0-99999999999999.99" |
Request JSON
"Form943/Get?submissionId=f2fee2f8-74bf-4e1d-9239-399e76929475"
Response JSON
{
"StatusCode": 200,
"StatusName": "Ok",
"StatusMessage": "Successful API call",
"SubmissionId": "2f430962-2278-4a3c-8310-02298004a375",
"Form943Records": [
{
"RecordId": "ba073cc7-ca7e-4518-a932-16a06d89430b",
"ReturnHeader": {
"ReturnType": "Form943",
"TaxYr": "2022",
"Business": {
"BusinessId": "2846e02d-dceb-4dd2-9039-a53a8bd2ee35",
"BusinessNm": "Rhonda Agri LLC",
"TradeNm": null,
"IsEIN": true,
"EINorSSN": "123456789",
"Email": "rhondas.r@agrillc.com",
"ContactNm": "Rhonda Charles",
"Phone": "1234567890",
"PhoneExtn": null,
"Fax": "(123) 456-7890",
"BusinessType": "CORP",
"SigningAuthority": {
"Name": "Rhonda Charles",
"Phone": "1234567890",
"BusinessMemberType": "PRESIDENT"
},
"KindOfEmployer": null,
"KindOfPayer": null,
"IsBusinessTerminated": false,
"IsForeign": false,
"USAddress": {
"Address1": "123 Kinsley Rd",
"Address2": "Main St",
"City": "Seattle",
"State": "WA",
"ZipCd": "98944"
},
"ForeignAddress": {
"Address1": null,
"Address2": null,
"City": null,
"ProvinceOrStateNm": null,
"Country": null,
"PostalCd": null
}
},
"IsThirdPartyDesignee": false,
"ThirdPartyDesignee": null,
"SignatureDetails": {
"SignatureType": "ONLINE_SIGN_PIN",
"OnlineSignaturePIN": {
"PIN": "1234567899"
},
"ReportingAgentPIN": null,
"Form8453EMP": null
},
"BusinessStatusDetails": {
"IsBusinessClosed": false,
"BusinessClosedDetails": null,
"IsBusinessTransferred": false,
"BusinessTransferredDetails": null,
"IsSeasonalEmployer": false
}
},
"ReturnData": {
"Form943": {
"EmployeeCnt": 5,
"SocialSecurityTaxCashWagesAmt": 100.00,
"SocialSecurityTaxAmt": 100.00,
"MedicareTaxCashWagesAmt": 100.00,
"MedicareTaxWithheldAmt": 100.00,
"TotMedcrTaxCashWagesAddnlWhAmt": 100.00,
"AddnlMedicareTaxWithholdingAmt": 100.00,
"FederalIncomeTaxWithheldAmt": 100.00,
"TotalTaxBeforeAdjustmentAmt": 100.00,
"CurrentYearAdjustmentAmt": 100.00,
"TotalTaxAfterAdjustmentAmt": 100.00,
"PayrollTaxCreditAmt": 0.00,
"Form8974": null,
"TotalTaxAmt": 2000.00,
"TotalTaxDepositAmt": 20000.00,
"BalanceDueAmt": 100.00,
"OverpaidAmt": 18000.00,
"OverPaymentRecoveryType": ""
},
"IRSPaymentType": null,
"IRSPayment": null,
"FinalPayRoll": null,
"DepositScheduleType": {
"DepositorType": "MINTAXLIABILITY",
"MonthlyDepositor": null,
"SemiWeeklyDepositor": null,
"TotalTaxLiabilityWholeYearAmt": 3000.00
}
},
"ReturnNumber": "6U000582013126-4"
}
],
"Errors": null
}