Get
Gets information of 940 returns by Submission Id.
GET Form940/Get
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. |
Form940Records | object[] | Employer's Form 940 information. |
  RecordId | Guid | Unique identifier of a record. |
  ReturnHeader | object | Identifies the supporting details of Form 940/940SCHR |
    ReturnType | string | Type of the return to be filed. Enter values like FORM940, FORM940PR, FORM940SS, FORM940SCHR. |
    TaxYr | string | Tax year for which Form 940/940 SCH R needs to be 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 | When IsEIN is true, use Employer Identification Number (EIN). When IsEIN is false, use 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. 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 | Identifies the kind of payer. This field is mandatory in W-2 and optional in 1099-MISC and 94X series. |
      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 | State code of the employer/payer. Refer Static values. |
        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 country code. Refer Static values. |
        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 940. |
      SignatureType | string | Type of signature used to sign Form 940 |
      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. |
  ReturnData | object | Identifies the Form 940 data. |
    Form940 | object | Information of Form 940, Employer's Annual Federal Unemployment (FUTA) Tax Return |
      OneStateCd | string | Line 1a. If you had to pay state unemployment tax in one state only, enter the state abbreviation. |
      IsCreditReduction | Boolean | When true, identifies that you paid wages in a state that is subject to CREDIT REDUCTION (Form 940, Line 2). Complete Schedule A (Form 940). |
      IsSuccessorEmployer | Boolean | When true, identifies the employer as a successor employer. Not applicable for 940SCHR. |
      IsPymtsMadeToEmployees | Boolean | When true, idetifies that the employer has made no payments to their employees. Not applicable for 940SCHR. |
      IsBusinessClosed | Boolean | When true, identifies the business as terminated or stopped paying wages. Not applicable for 940SCHR. |
      IsMultiState | Boolean | When true, identifies the employer as a multi-state employer. |
      WagesAmt | number | Gets the amount of the total payments made to all employees. Line 3. |
      ExemptWagesAmt | number | Gets the amount of the payments exempt from FUTA tax. Line 4. |
      IsFringeBenfs | Boolean | When true, identifies the payments exempt from FUTA tax has Fringe Benefits. |
      IsGrpTermLifeIns | Boolean | When true, identifies the payments exempt from FUTA tax has Group-term life insurance. |
      IsRetrmntOrPension | Boolean | When true, identifies the payments exempt from FUTA tax has Retirement/Pension. |
      IsDepCare | Boolean | When true, identifies the payments exempt from FUTA tax has Dependent care. |
      IsOtherExempt | Boolean | When true, identifies the payments exempt from FUTA tax has other Exempt. |
      WagesOverLmtAmt | number | Gets the total amount of the payments made to each employee in excess of $7,000. Line 5 |
      TotExemptWagesAmt | number | Gets the subtotal amount by adding the amounts on Line 4 and 5 on Line 6. |
      TotTaxableWagesAmt | number | Gets the total taxable FUTA wages by subtracting the amount on line 6 from line 3 on line 7. |
      FUTATaxBeforeAdjAmt | number | Gets the total FUTA tax before adjustments by multiplying line 7 by 0.006 on line 8. |
      MaxCreditAmt | number | Gets the amount by multiplying line 7 by 0.054 on line 9 if all taxable FUTA wages paid were excluded from state unemployment tax. Line 9. |
      FUTAAdjAmt | number | Gets some of the taxable FUTA Wages that were excluded from State Unemployment Tax or the late payments that were made for state unemployment tax |
      TotCrdtRedAmt | number | Gets the FUTA taxable wages that were also subject to state unemployment taxes in any states that are subject to credit recuction. Line 11. |
      FUTATaxAfterAdjAmt | number | Gets the total FUTA tax after adjustments amount by adding the amounts on Lines 8, 9, 10, 11. Line 12. |
      TotDepositAmt | number | Gets the amount of FUTA tax deposited for the year, including any overpayment applied from a prior year. Line 13. |
      FirstQtrTaxLiabilityAmt | number | Gets the FUTA Tax Liability amount for 1st quarter (January 1 – March 31). Line 16a. |
      secondQtrTaxLiabilityAmt | number | Gets the FUTA Tax Liability amount for 2nd quarter (April 1 – June 30). Line 16b. |
      ThirdQtrTaxLiabilityAmt | number | Gets the FUTA Tax Liability amount for 3rd quarter (July 1 – September 30). Line 16c. |
      FourthQtrTaxLiabilityAmt | number | Gets the FUTA Tax Liability amount for 4th quarter (October 1 – December 31). Line 16d. |
      TotTaxLiabilityAmt | number | Gets the total FUTA tax liability amount for the year. Line 17. |
      BalanceDueAmt | number | Gets the difference amount of the balance due if line 12 is more than line 13. Line 14 |
      OverPaidAmt | number | Gets the difference overpayment amount if line 13 is more than line 12. Line 15. |
      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. |
    IRSPaymentType | string | Payment type to make payments to the IRS. Choose from 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 |
    FinalPayRoll | object | Identifies name and address of the Record Keeper |
      PersonNm | string | Name of the Record Keeper |
      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 | State code of the employer/payer. Refer Static values. |
        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 country code. Refer Static values. |
        PostalCd | string | Employer/Payer's postal code |
    ScheduleA | object[] | Schedule A (Form 940), Multi-State Employer and Credit Reduction Information |
      StateCd | string | State code of the employer/client. Refer Static values. |
      TotTaxableFUTAwagesAmt | number | Total taxable FUTA wages amount of the state. |
      CreditReductionRt | number | Credit Reduction Rate of the state |
      CreditReductionAmt | number | Credit Reduction amount of the state. This will be equal to the Total taxable FUTA wages amount multiplied with the Credit Reduction Rate. (Round of the amount upto 2 digits after decimal point). |
  ReturnNumber | number | Return Number from IRS |
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
"Form940/Get?SubmissionId=85c5f31d-af1e-4c07-8e4d-9f481be29446"
Response JSON
{ "StatusCode": 200, "StatusName": "Ok", "StatusMessage": "Successful API call", "SubmissionId": "85c5f31d-af1e-4c07-8e4d-9f481be29446", "Form940Records": [ { "RecordId": "cd012b18-d44a-40c4-96f2-ec6570eaaafc", "RecordStatus": "Created", "ReturnHeader": { "ReturnType": "Form940", "TaxYr": "2020", "Business": { "BusinessId": "f8f88c28-b248-492f-b00f-7a16a9c4008c", "PayerAccNum": null, "BusinessNm": "Eastman Kodak Company", "TradeNm": null, "IsEIN": true, "EINorSSN": "008587894", "Email": "john@gmail.com", "ContactNm": "John", "Phone": "8798798798", "PhoneExtn": null, "Fax": "(798) 798-7987", "BusinessType": "PART", "SigningAuthority": { "Name": "John", "Phone": "7987987987", "BusinessMemberType": "PARTNER" }, "KindOfEmployer": null, "KindOfPayer": null, "IsBusinessTerminated": false, "IsForeign": false, "USAddress": { "Address1": "12 main st", "Address2": null, "City": "Rock Hill", "State": "SC", "ZipCd": "29730" }, "ForeignAddress": null }, "IsThirdPartyDesignee": false, "ThirdPartyDesignee": null, "SignatureDetails": { "SignatureType": "ONLINE_SIGN_PIN", "OnlineSignaturePIN": { "PIN": "1234567891" }, "ReportingAgentPIN": null, "Form8453EMP": null } }, "ReturnData": { "Form940": { "IsSuccessorEmployer": false, "IsPymtsMadeToEmployees": true, "IsBusinessClosed": false, "OneStateCd": "VI", "IsCreditReduction": true, "IsMultiState": false, "WagesAmt": 500000, "ExemptWagesAmt": 20000, "IsFringeBenfs": true, "IsGrpTermLifeIns": false, "IsRetrmntOrPension": false, "IsDepCare": false, "IsOtherExempt": false, "WagesOverLmtAmt": 0, "TotExemptWagesAmt": 20000, "TotTaxableWagesAmt": 480000, "FUTATaxBeforeAdjAmt": 2880, "MaxCreditAmt": 0, "FUTAAdjAmt": 0, "TotCrdtRedAmt": 12960, "FUTATaxAfterAdjAmt": 15840, "TotDepositAmt": 15840, "FirstQtrTaxLiabilityAmt": 0, "secondQtrTaxLiabilityAmt": 0, "ThirdQtrTaxLiabilityAmt": 0, "FourthQtrTaxLiabilityAmt": 15840, "TotTaxLiabilityAmt": 15840, "BalanceDueAmt": 0, "OverPaidAmt": 0, "OverPaymentRecoveryType": null }, "IRSPaymentType": null, "IRSPayment": { "BankRoutingNum": null, "AccountType": null, "BankAccountNum": null, "Phone": null }, "FinalPayRoll": { "PersonNm": null, "IsForeign": false, "USAddress": null, "ForeignAddress": null }, "ScheduleA": [ { "StateCd": "VI", "TotTaxableFUTAwagesAmt": 432000, "CreditReductionRt": 0.03, "CreditReductionAmt": 12960 } ] }, "ReturnNumber": "6R001882112003-14" } ], "Errors": []}