Get

Get

Use this endpoint to retrieve the information of a previously created NC-3 form for the corresponding payer. Your request JSON must include the corresponding SubmissionId and the RecordId (optional) for the forms.

GET StateFilings/NC3ANNUALRECON/Get 

Run in Postman

Request Body

Field	Type	Description
SubmissionId	Guid	Unique identifier created by TaxBandits for each submission.
RecordId	Guid	Optional A unique identifier generated by TaxBandits when an NC-3 return is created. Mention the return's Record ID that you want to get.

Response Body

Field	Type	Description
SubmissionId	String	Unique identifier for the submission.
StateWHRecords	Object[]	Object to identify the records.
SequenceId	String	A unique identifier for this record.
ReturnHeader	Object	Contains business information.
TaxYear	String	The tax year for which the Form NC-3 is to be filed.
Qtr	String	The quarter for which the Form NC-3 is to be filed.
Business	object	Object to identify the Business Details.
BusinessId	Guid	The unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint.
PayerRef	string	The unique identifier for the payer.
IsDefaultBusiness	Boolean	When set to TRUE, this business will be set as the default across requests that do not specify a business.
TINDetails	object	TIN information for the business.
Format	string	Specifies how the TIN is passed.
TINType	string	Specify the TIN type of the business.
TIN	string	The TIN value according to the Format selected.
IndividualNm	object	Required when TINType is SSN. Provide individual name fields instead of BusinessNm.
FirstNm	string	The first name of the individual.
MiddleNm	string	Middle name of the individual
LastNm	string	The last name of the individual.
Suffix	string	Suffix of the individual's name.
BusinessNm	string	Legal name of the business. Required when TINType is EIN.
NameCtrl	string	Name control of the business as registered with the IRS.
DBADetails	object[]	DBA (Doing Business As) information.
DBANm	string	Name of the DBA.
DBARef	string	Unique identifier for the DBA.
DBAId	Guid	TaxBandits-generated DBA identifier.
Address	object[]	Address information of the DBA.
Address1	string	Street address or PO Box.
Address2	string	Optional Suite or apartment number.
City	string	DBA's city.
ProvinceOrState	string	DBA's province or state name.
Zipcd	string	DBA's ZIP code.
Country	string	DBA's 2-character country code.
Email	string	Email address of the Business.
Address	object	Primary address of the business.
Address1	string	Street address or PO Box of the business.
Address2	string	Suite or apartment number of the business.
City	string	City of the business.
ProvinceOrState	string	Province or state name of the business.
ZipCd	string	ZIP code of the business.
Country	string	2-character country code of the business.
ContactDetails	object[]	Details of the person the IRS can contact regarding the given business.
FirstNm	string	First name of the contact person.
MiddleNm	string	Middle name of the contact person.
LastNm	string	Last name of the contact person.
Suffix	string	The suffix of the contact person.
Phone	string	Phone number of the contact person.
PhoneExtn	string	Phone extension number.
Email	string	Email address of the contact person.
Fax	string	Fax number of the contact person.
SigningAuthority	Object	Details of the person authorized to sign the return.
FirstNm	String	First name of the signatory.
MiddleNm	String	Middle name of the signatory.
LastNm	String	Last name of the signatory.
Suffix	String	The suffix of the signatory.
Phone	String	Phone number of the signatory.
PhoneExtn	String	Phone extension number of the signatory.
BusinessMemberType	String	Title or role of the signatory.
ReturnData	Object[]	Identifies the Form NC-3 data.
FormNC3	Object	North Carolina annual withholding reconciliation tax return. Note: Since Form NC-3 is an annual reconciliation form, it must be filed only for the fourth quarter of the tax year.
WHIdNum	String	North Carolina withholding account number.
OperationCeasedDt	String	If the business was closed or stopped paying wages during the tax year, enter the date the business was closed in the format: MM/DD/YYYY or MM-DD-YYYY (Example: 01/25/2026).
TaxWHDetails	Object	Object that contains information about total tax withheld reported to the North Carolina Department for the tax year
Jan	Number	Total tax withheld reported to the North Carolina Department for the month of January.
Feb	Number	Total tax withheld reported to the North Carolina Department for the month of February.
Mar	Number	Total tax withheld reported to the North Carolina Department for the month of March.
Apr	Number	Total tax withheld reported to the North Carolina Department for the month of April.
May	Number	Total tax withheld reported to the North Carolina Department for the month of May.
Jun	Number	Total tax withheld reported to the North Carolina Department for the month of June.
Jul	Number	Total tax withheld reported to the North Carolina Department for the month of July.
Aug	Number	Total tax withheld reported to the North Carolina Department for the month of August.
Sep	Number	Total tax withheld reported to the North Carolina Department for the month of September.
Oct	Number	Total tax withheld reported to the North Carolina Department for the month of October.
Nov	Number	Total tax withheld reported to the North Carolina Department for the month of November.
Dec	Number	Total tax withheld reported to the North Carolina Department for the month of December.
TotTaxWH	Number	Total tax withheld reported to the North Carolina Department for all the months of the tax year.
TaxWHW2	Number	Tax Withheld as Reported on W-2 Statements
TaxWH1099	Number	Tax Withheld as Reported on 1099 Statements
TotTaxWHRep	Number	Total Tax Withheld as Reported to the Department of North Carolina
TotTaxRep	Number	Total Tax Withheld as Reported on W-2 and 1099 Statements
Overpayment	Number	Overpayment amount for the tax year. It is required only if Total Tax Withheld as Reported to the Department of North Carolina is greater than Total Tax Withheld as Reported on W-2 and 1099 Statements.
TaxAdj	Number	Additional Tax Due for the tax year. It is required only if Total Tax Withheld as Reported on W-2 and 1099 Statements is greater than Total Tax Withheld as Reported to the Department of North Carolina
Interest	Number	Interest amount for the tax year.
Penalty	object	object that contains Informational Return Penalties details.
LateFilingPenalty	Number	Penalty imposed, if any, for failure to file by the due date
LateRepPenalty	Number	Penalty imposed, if any, for failure to File in Format
TotPenalties	Number	Total penalties imposed for the tax year
Refund	Number	Amount of Refund Requested for the tax year.
BalanceDue	Number	Total Amount Due for the tax year
StatePayment	Object	Object that contains information about payment details for the department of North Carolina
AccountType	String	Type of the bank account
BankRoutingNum	String	Bank routing number
BankAccountNum	String	Bank Account Number
PaymentAmt	Number	Amount to be paid to the department of North Carolina
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

Request JSON

"statefilings/nc3annualrecon/get?SubmissionId=01a0e790-7d93-77cf-8bb8-ec0638ee297f&RecordId=01a0e790-7f65-74b0-a64a-6972eac60431"

Response JSON

200

Success Response - This is a sample response for successful API requests.

{
"SubmissionId": "01a0e790-7d93-77cf-8bb8-ec0638ee297f",
"StateWHRecords": [
  {
    "SequenceId": "001",
    "RecordId": "01a0e790-7f65-74b0-a64a-6972eac60431",
    "ReturnHeader": {
      "Qtr": "Q4",
      "TaxYear": "2025",
      "Business": {
        "BusinessId": "2c142376-22db-4e67-835e-f31af93de1b1",
        "PayerRef": null,
        "IsDefaultBusiness": true,
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "15-9811483"
        },
        "BusinessNm": "Snowdaze LLC",
        "DBADetails": {
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "DBAId": "40C18CBD-4624-4CFE-BBC2-6898641F275E",
          "Address": {
            "Address1": "123 Main St",
            "Address2": "Suite 1001",
            "City": "Rock Hill",
            "ProvinceOrState": "SC",
            "ZipCd": "29730",
            "Country": "US"
          }
        },
        "Address": {
          "Address1": "123 Main St",
          "Address2": "Suite 1001",
          "City": "Rock Hill",
          "ProvinceOrState": "SC",
          "ZipCd": "29730",
          "Country": "US"
        },
        "ContactDetails": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr",
          "Phone": "(803) 555-1234",
          "PhoneExtn": "101",
          "Email": "contact@snowdaze.com",
          "Fax": "(803) 555-5678"
        },
        "BusinessType": "ESTE",
        "SigningAuthority": {
          "FirstNm": "Ambrane",
          "MiddleNm": "A",
          "LastNm": "Cavil",
          "Suffix": "Jr",
          "Phone": "(803) 555-1000",
          "PhoneExtn": "111",
          "BusinessMemberType": "ADMINISTRATOR"
        },
        "KindOfEmployer": null,
        "KindOfPayer": null
      }
    },
    "ReturnData": {
      "FormNC3": {
        "WHIdNum": "173566979",
        "OperationCeasedDt": "04/10/2025",
        "TaxWHDetails": {
          "Jan": 100,
          "Feb": 100,
          "Mar": 100,
          "Apr": 100,
          "May": 100,
          "Jun": 100,
          "Jul": 100,
          "Aug": 100,
          "Sep": 100,
          "Oct": 100,
          "Nov": 100,
          "Dec": 100
        },
        "TotTaxWH": 1200,
        "TaxWH2": 1000,
        "TaxWH1099": 200,
        "TotTaxWHRep": 1200,
        "TotTaxRep": 1200,
        "Overpayment": 0,
        "TaxAdj": 0,
        "Interest": 0,
        "Penalty": {
          "LateFilingPenalty": null,
          "LatePenPenalty": null,
          "TotPenalties": null
        },
        "Refund": 0,
        "BalanceDue": 0
      },
      "StatePayment": {
        "BankRoutingNum": "217555555",
        "BankAccountNum": "00133",
        "PaymentAmt": 100,
        "AccountType": "PERSONAL_CHECKING"
      }
    }
  }
],
"Errors": null
}