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