Extend your software with TaxBandits IRS E-file API Integration

Skip to main content
Version: 1.6.1

Get

Gets information of 943 returns by Submission Id.

GET Form943/Get

Request Parameters

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission

Response Parameters

FieldTypeDescription
StatusCodenumberReturns the HTTP status codes like 200,300 etc.
StatusNamestringName of the status code.
StatusMessagestringDetailed status message.
SubmissionIdGuidUnique identifier of a submission
Form943Recordsobject[]Employer's Form 943 information.
    RecordIdGuidUnique identifier of a record
    ReturnHeaderobjectIdentifies the supporting details of Form 943.
        ReturnTypestringType of the return filed.
        TaxYrstringThe Tax year for which Form 943 has been filed.
        BusinessobjectBusiness Details
            BusinessNmstringName of the business
            TradeNmstringOptional Name under which the business operates
            IsEINBooleanWhen true, identifies the business with an EIN.
            EINorSSNstringEmployer Identification Number (EIN). When IsEIN is false, Social Security Number (SSN).
            EmailstringEmail address of the Business
            ContactNmstringName of the person who can be contacted by the IRS
            PhonestringContact number of the business with area code
            PhoneExtnstringOptional Extension of the business phone number
            FaxstringOptional Fax number of the Business
            BusinessTypestringType of business.
            SigningAuthorityobjectDetails of the person who is authorized to sign the return
                NamestringName of the signing authority.
                PhonestringPhone number of the signing authority.
                BusinessMemberTypestringBusiness title of the signing authority
            KindOfEmployerstringIdentifies the kind of employer. Mandatory for W-2 and optional for 1099-MISC and 94X series.
            KindOfPayerstringKind Of Payer based on the Employer's Federal Tax Return.
            IsBusinessTerminatedBooleanWhen true, identifies the business as terminated.
            IsForeignBooleanWhen true, identifies the business address with a foreign address.
            USAddressobjectif IsForeign is false, US address of the business
                Address1stringEmployer/Payer's US address (street address or post office box of that locality)
                Address2stringOptional Employer/Payer's suite or apartment
                CitystringEmployer/Payer's city
                StatestringEmployer/Payer's state
                ZipCdstringEmployer/Payer's zip code
            ForeignAddressobjectif IsForeign is true, pass foreign address of the business
                Address1stringEmployer/Payer's foreign address (street address or post office box of that locality).
                Address2stringOptional Employer/Payer's suite or apartment
                CitystringEmployer/Payer's city
                ProvinceOrStateNmstringEmployer/Payer's province or state name
                CountrystringEmployer/Payer's country
                PostalCdstringEmployer/Payer's postal code
        IsThirdPartyDesigneeBooleanWhen true, your third-party designee is allowed to discuss the return with the IRS.
        ThirdPartyDesigneeobjectThird Party Designee Details
            NamestringThird Party Designee's name.
            PhonestringThird Party Designee's phone number
            PINstringA 5 digit PIN (Should not contain all zeroes) used when communicating to the IRS
        SignatureDetailsobjectIdentifies the signature type used in Form 943
            SignatureTypestringType of signature used to sign Form 943
            OnlineSignaturePINobjectA 10-digit signature PIN to become an IRS authorized signer.
                PINstringSign using a 10 digit PIN received from the IRS.
            ReportingAgentPINobjectA 5-digit number assigned by the IRS
                PINstringSign using a 5 digit PIN received from the IRS.
            Form8453EMPobjectAn alternate option to sign the return using Form 8453 EMP when there is no PIN
                AttachmentNmstringName of the Form 8453EMP attachment
                Attachmentbyte[]Byte array of Form-8453 pdf
                AttachmentFileTypestringType of the file Attachment
                SignedDateDateTimeDate and time on which the Form 8453-EMP was signed
        BusinessStatusDetailsobjectIdentifies the status of the Business
            IsBusinessClosedBooleanWhen true, identifies the business as terminated or stopped paying wages
            BusinessClosedDetailsobjectIdentifies the Record Keeper details and date on which the Buiness was closed
                NamestringName of the Record Keeper
                FinalDateWagesPaidDateTimeFinal date on which the business last paid the wages
                IsForeignBooleanWhen true, identifies if the business has a foreign address.
                USAddressobjectif IsForeign is false, pass US address of the business
                    Address1stringEmployer/Payer's US address (street address or post office box of that locality)
                    Address2stringOptional Employer/Payer's suite or apartment
                    CitystringEmployer/Payer's city
                    StatestringEmployer/Payer's state
                    ZipCdstringEmployer/Payer's zip code
                ForeignAddressobjectif IsForeign is true, pass foreign address of the business
                    Address1stringEmployer/Payer's foreign address (street address or post office box of that locality)
                    Address2stringOptional Employer/Payer's suite or apartment
                    CitystringEmployer/Payer's city
                    ProvinceOrStateNmstringEmployer/Payer's province or state name
                    CountrystringEmployer/Payer's country
                    PostalCdstringEmployer/Payer's postal code
    ReturnDataobjectIdentifies the Form 943 data
        Form943objectForm 943, Employer’s QUARTERLY Federal Tax Return
            PriorAddressIndBooleanWhen true, If address is different from prior return.
            EmployeeCntnumberGets the number of Employees who has received wages, tips, or other compensation for the pay period. Line 1
            SocialSecurityTaxCashWagesAmt_Col1numberGets the taxable social security wages amount. Line 2
            SocialSecurityTaxAmtnumberGets the taxable social security tips amount. Line 3
            MedicareTaxCashWagesAmtnumberGets the taxable medicare wages and tips amount. Line 4
            MedicareTaxWithheldAmtnumberGets the taxable medicare withheld amount. Line 5
            TotMedcrTaxCashWagesAddnlWhAmtnumberGets the taxable wages and tips subject to additional Medicare Tax withholding amount. Line 6
            AddnlMedicareTaxWithholdingAmtnumberGets additional Medicare Tax withholding amount. Line 7
            FederalIncomeTaxWithheldAmtnumberGets the tax on Federal Income Tax withheld. Line 8
            TotalTaxBeforeAdjustmentAmtnumberGets the total taxes beofre adjustments by adding lines 3, 5,7 and 8. Line 9
            CurrentYearAdjustmentAmtnumberGets the tax on current year's adjustments. Line 10
            TotalTaxAfterAdjustmentAmtnumberGets the Total taxes Security after adding adjustments by line 9 adjusted by line 10. Line 11
            PayrollTaxCreditAmtnumberGets the tax for qualified small business payroll tax credits.line 12
            TotalTaxAmtnumberGets the Total taxes after adjustments and credits by subtracting line 12 from line 11.Line 13.
            TotalTaxDepositAmtnumberGets the amount of total tax deposits including overpayment applied from prior year and Form 943-x. Line 14.
            BalanceDueAmtnumberGets the amount of difference between line 13 and line 14, if line 13 is greater than line 14. Line 15.
            OverpaidAmtnumberGets the amount difference between line 14 and line 13, if line 14 is greater than line 13. Line 16.
            IsOverPaymentBooleanWhen 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.
            Form8974objectInformation of Form 8974
                Form8974IncomeTaxDetailsobject[]Collection of Income Tax details
                    IncomeTaxPeriodEndDatestringGets the ending date of income tax period in Part 1 Column (a).
                    IncomeTaxReturnFiledFormstringGets 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)
                    IncomeTaxReturnFiledDatestringGets the income tax return filing date shown in column (b). Part 1 Column (c)
                    Form6765EINstringGets 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)
                    Form6765Line44AmtnumberGets the amount from Form 6765, line 44 or the amount allocated to your EIN if applicable. Part 1 Column (e)
                    PreviousPeriodRemainingCreditAmtnumberGets the amount of credit from column (e) taken on a previous period(s). Part 1 Column (f)
                    RemainingCreditnumberGets the total amount of remaining credit by subtracting column (f) from column (e). Part 1 Column (g).
                Line7numberGets the total amount from Part 1, line 6(g). Part 2 Line 7.
                Line8numberGets 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.
                Line9numberGets 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.
                Line10numberGets the total amount by adding the amounts of lines 8 and 9. Part 2 Line 10.
                Line11numberGets 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.
                PayerIndicatorTypestringIdentifies if you are a Third-party payer of sick pay or received a Section 3121(q) Notice and Demand
                Line12numberGets 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
            TotTaxDepositAmtnumberGets 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
            OverPaymentRecoveryTypestringGets 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.
            FilerTypestringType of Form 943 filer
        IRSPaymentTypestringEFW, EFTPS, Check or Money Order
        IRSPaymentobjectIdentifies the details of Electronic Funds Withdrawal (EFW) if paying the balance due along with the return
            BankRoutingNumstringBank Routing Number of EFW payment
            AccountTypestringAccount Type (Checking or Saving) of EFW payment
            BankAccountNumstringBank Account Number of EFW payment
            PhonestringPhone of EFW payment
        DepositScheduleTypeobjectIdentifies the Employer's deposit schedule and tax liability for the quarter
            DepositorTypestringType of Deposit Schedule. Values like Monthly or Semi Weekly
            MonthlyDepositorobjectLine 16, Option 2. Monthly Schedule Depositor
                JanTaxLiabilitynumberTax Liability for January.
                FebTaxLiabilitynumberTax Liability for Febraury.
                MarTaxLiabilitynumberTax Liability for March.
                AprTaxLiabilitynumberTax Liability for April.
                MayTaxLiabilitynumberTax Liability for May.
                JunTaxLiabilitynumberTax Liability for June.
                JulTaxLiabilitynumberTax Liability for July.
                AugTaxLiabilitynumberTax Liability for August.
                SepTaxLiabilitynumberTax Liability for September.
                OctTaxLiabilitynumberTax Liability for October.
                NovTaxLiabilitynumberTax Liability for November.
                DecTaxLiabilitynumberTax Liability for December.
            TaxLiabilityTotalAmtnumberTotal tax liability amount.
            SemiWeeklyDepositorobjectLine 16, Option 3. SemiWeekly Depositor
                Form943AJanMonthAmtobject[]Tax Liability for January in Form 943 A.
                    DaystringTax 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"
                    Amtnumber.
Size Range: 0-99999999999999.99
                Form943AJanMonthTotAmtobject[]Total Tax Liability for January in Form 943 A.
                Form943AFebMonthAmtobject[]Tax Liability for February in Form 943 A.
                    Amtnumber.
Size Range: 0-99999999999999.99
                Form943AFebMonthTotAmtobject[]Total Tax Liability for February in Form 943 A.
                Form943AMarMonthAmtobject[]Tax Liability for March in Form 943 A.
                    DaystringTax 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"
                    Amtnumber.
Size Range: 0-99999999999999.99
                Form943AJMarMonthTotAmtobject[]Total Tax Liability for March in Form 943 A.
                Form943AAprMonthAmtobject[]Tax Liability for April in Form 943 A.
                    Amtnumber.
Size Range: 0-99999999999999.99
                Form943AAprMonthTotAmtobject[]Total Tax Liability for April in Form 943 A.
                Form943AMayMonthAmtobject[]Tax Liability for May in Form 943 A.
                    Amtnumber.
Size Range: 0-99999999999999.99
                Form943AMayMonthTotAmtobject[]Total Tax Liability for May in Form 943 A.
                Form943AJunMonthAmtobject[]Tax Liability for Jume in Form 943 A.
                    Amtnumber.
Size Range: 0-99999999999999.99
                Form943AJunMonthTotAmtobject[]Total Tax Liability for June in Form 943 A.
                Form943AJulMonthAmtobject[]Tax Liability for July in Form 943 A.
                    Amtnumber.
Size Range: 0-99999999999999.99
                Form943AJulMonthTotAmtobject[]Total Tax Liability for July in Form 943 A.
                Form943AAugMonthAmtobject[]Tax Liability for August in Form 943 A.
                    Amtnumber.
Size Range: 0-99999999999999.99
                Form943AAugMonthTotAmtobject[]Total Tax Liability for August in Form 943 A.
                Form943ASepMonthAmtobject[]Tax Liability for September in Form 943 A.
                    Amtnumber.
Size Range: 0-99999999999999.99
                Form943ASepMonthTotAmtobject[]Total Tax Liability for September in Form 943 A.
                Form943AOctMonthAmtobject[]Tax Liability for October in Form 943 A.
                    Amtnumber.
Size Range: 0-99999999999999.99
                Form943AOctMonthTotAmtobject[]Total Tax Liability for October in Form 943 A.
                Form943ANovMonthAmtobject[]Tax Liability for November in Form 943 A.
                    Amtnumber.
Size Range: 0-99999999999999.99
                Form943ANovMonthTotAmtobject[]Total Tax Liability for November in Form 943 A.
                Form943ADecMonthAmtobject[]Tax Liability for December in Form 943 A.
                    Amtnumber.
Size Range: 0-99999999999999.99
                Form943ADecMonthTotAmtobject[]Total Tax Liability for December in Form 943 A.
ReturnNumberstringUnique number of a return
Errorsobject[]Shows detailed error information
    CodestringReturns the validation error code.
    NamestringName of the validation error.
    MessagestringDescription of the validation error.
    TypestringType 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}