Skip to main content
Version: 1.7.3

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 Params

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission. Not required when you are creating a return.
RecordIdGuidA unique identifier generated by TaxBandits when an NC-3 return is created. Mention the return's Record ID that you want to get.

Request Body

FieldTypeDescription
SubmissionIdGuidUnique identifier created by TaxBandits for each submission. Not required when you are creating a return.
StateWHRecordsObject[]Object to create  NC-3
SequenceIdStringA unique number given by an inbound application to identify failed records.
Size Range: ..50
ReturnHeaderObjectIdentifies the supporting details of Form  NC-3.
QtrStringThe Quarter for which Form  NC-3 needs to be filed.
Allowed values

"Q1", "Q2", "Q3", "Q4"


Since Form NC-3 is an annual reconciliation form, it must be filed only for the fourth quarter of the tax year.
TaxYrStringThe tax year for which Form  NC-3 needs to be filed.
Allowed values

  2025

BusinessObjectObject to identify the business details.
BusinessIdGuidOptional Use the unique identifier provided in the response from the Business CREATE endpoint.
BusinessNmstringName of the business.
Size Range: ..75
TradeNmstringOptional Name under which the business operates.
Size Range: ..75
IsEINBooleanWhen true, identifies the business with an EIN.
EINorSSNstringWhen IsEIN is true, use the Employer Identification Number (EIN)
Note: IsEIN should always be set to true, as EIN is the only allowed TIN type for state payroll forms.
Size Range: 9-11
EmailstringOptional Email address of the business.
Size Range: ..100
ContactNmstringOptional Name of the person who can be contacted by the State Agency.
Size Range: ..27
PhonestringOptional Phone number of the business.
Size Range: 10
PhoneExtnstringOptional Extension of the business phone number.
Size Range: ..5
FaxstringOptional Fax number of the business.
Size Range: 10
BusinessTypestringType of business.
Size Range: 4
Allowed values

"ESTE", "PART", "CORP", "EORG", "SPRO"

SigningAuthorityobjectDetails of the person who is authorized to sign the return.
NamestringName of the signing authority.
Size Range: ..35
PhonestringPhone number of the signing authority.
Size Range: 10
BusinessMemberTypestringBusiness title of the signing authority
Size Range: 5..29
Allowed values

"CORPORATESECRETARY", "SECRETARYTREASURER", "PARTNER", "GENERALPARTNER", "LIMITEDPARTNER", "LLCMEMBER", "MANAGINGMEMBER", "MANAGER", "TAXMATTERPARTNER", "PRESIDENT", "VICEPRESIDENT", "CORPORATETREASURER", "TREASURER", "ASSISTANTTREASURER", "CHIEFACCOUNTINGOFFICER", "CHIEFEXECUTIVEOFFICER", "CHIEFFINANCIALOFFICER", "TAXOFFICER", "CHIEFOPERATINGOFFICER", "CORPORATEOFFICER", "EXECUTIVEDIRECTOR", "DIRECTOR", "CHAIRMAN", "EXECUTIVEADMINISTRATOR", "RECEIVER", "PASTOR", "ASSISTANTTORELIGIOUSLEADER", "REVEREND", "PRIEST", "MINISTER", "RABBI", "LEADEROFRELIGIOUSORGANIZATION", "SECRETARY", "DIRECTOROFTAXATION", "DIRECTOROFPERSONNEL", "ADMINISTRATOR", "EXECUTOR", "TRUSTEE", "FIDUCIARY", "OWNER", "SOLEPROPRIETOR", "MEMBER", "SOLEMEMBER"

KindOfEmployerstringOptional Identifies the kind of employer.
Allowed values

"FEDERALGOVT", "STATEORLOCAL501C", "NONGOVT501C", "STATEORLOCALNON501C", "NONEAPPLY"

KindOfPayerstringOptional Identifies the kind of payer.
Allowed values

"REGULAR941", "REGULAR944", "AGRICULTURAL943", "HOUSEHOLD", "MILITARY", "MEDICAREQUALGOVEM", "RAILROADFORMCT1"

IsBusinessTerminatedBooleanWhen true, indicates that the business is terminated.
IsForeignObjectWhen true, indicates that the business has a foreign address.
USAddressobjectIf IsForeign is false, pass the US address of the business.
Address1stringEmployer/Payer's US address (street or post office box of that locality).
Size Range: ..46
Address2stringOptional Employer/Payer's suite or apartment.
Size Range: ..46
CitystringEmployer/Payer's city.
Size Range: ..50
StatestringEmployer/Payer's state code. Refer to static values.
Size Range: 2
Allowed values

"AL", "AK", "AZ", "AR", "CA", "CO", "CT", "DE", "DC", "FL", "GA", "HI", "ID", "IL", "IN", "IA", "KS", "KY", "LA", "ME", "MD", "MA", "MI", "MN", "MS", "MO", "MT", "NE", "NV", "NH", "NJ", "NM", "NY", "NC", "ND", "OH", "OK", "OR", "PA", "RI", "SC", "SD", "TN", "TX", "UT", "VT", "VA", "WA", "WV", "WI", "WY", "AS", "FM", "GU", "MH", "MP", "PW", "PR", "VI", "AA", "AE", "AP"

ZipCdstringEmployer/Payer's zip code.
Size Range: 5..10
ForeignAddressObjectIf IsForeign is true, pass the foreign address of the business.
Address1stringEmployer/Payer's foreign address (street address or post office box of that locality).
Size Range: ..50
Address2stringOptional Employer/Payer's suite or apartment.
Size Range: ..50
CitystringEmployer/Payer's city.
Size Range: ..50
ProvinceOrStateNmstringEmployer/Payer's province or state name.
Size Range: ..50
CountrystringEmployer/Payer's country.
Size Range: 2
Allowed values

"AF", "AX", "AL", "AG", "AQ", "AN", "AO", "AV", "AY", "AC", "AR", "AM", "AA", "AT", "AS", "AU", "AJ", "BF", "BA", "FQ", "BG", "BB", "BO", "BE", "BH", "BN", "BD", "BT", "BL", "BK", "BC", "BV", "BR", "IO", "VI", "BX", "BU", "UV", "BM", "BY", "CB", "CM", "CA", "CV", "CJ", "CT", "CD", "CI","CH", "KT", "IP", "CK", "CO", "CN", "CF", "CG", "CW", "CR", "CS", "IV", "HR", "CU", "UC", "CY", "EZ", "DA", "DX", "DJ", "DO", "DR", "TT", "EC", "EG", "ES", "EK", "ER", "EN", "ET", "FK", "FO", "FM", "FJ", "FI", "FR", "FP", "FS", "GB", "GA", "GG", "GM", "GH", "GI", "GR", "GL", "GJ", "GQ", "GT", "GK", "GV", "PU", "GY", "HA", "HM", "VT", "HO", "HK", "HQ", "HU", "IC", "IN", "ID", "IR", "IZ", "EI", "IS", "IT", "JM", "JN", "JA", "DQ", "JE", "JQ", "JO", "KZ", "KE", "KQ", "KR", "KN", "KS", "KV", "KU", "KG", "LA", "LG", "LE", "LT", "LI", "LY", "LS", "LH", "LU", "MC", "MK", "MA","MI", "MY", "MV", "ML", "MT", "IM", "RM", "MR", "MP", "MX", "MQ", "MD", "MN", "MG", "MJ", "MH", "MO", "MZ", "WA", "NR", "BQ", "NP", "NL", "NC", "NZ", "NU", "NG", "NI", "NE", "NF", "CQ", "NO", "MU", "OC", "PK", "PS", "LQ", "PM", "PP", "PF", "PA", "PE", "RP", "PC", "PL", "PO", "RQ", "QA", "RO", "RS", "RW", "TB", "RN", "WS", "SM", "TP", "SA", "SG", "RI", "SE", "SL", "SN", "NN", "LO", "SI", "BP", "SO", "SF", "SX", "OD", "SP", "PG", "CE", "SH", "SC", "ST", "SB", "VC", "SU", "NS", "SV", "WZ", "SW", "SZ", "SY", "TW", "TI", "TZ", "TH", "TO", "TL", "TN", "TD", "TS", "TU", "TX", "TK", "TV", "UG", "UP", "AE", "UK", "UY", "UZ", "NH", "VE", "VM", "VQ", "WQ", "WF", "WI", "YM", "ZA", "ZI"

PostalCdstringEmployer/Payer's postal code.
Size Range: ..16
PostalCdStringEmployer/Payer’s postal code.
Size Range: ..16
ReturnDataObject[]Identifies the Form  NC-3 data.
FormNC3ObjectNorth Carolina annual withholding reconciliation tax returnNote: Since Form NC-3 is an annual reconciliation form, it must be filed only for the fourth quarter of the tax year.
WHIdNumStringNorth Carolina withholding account number.
Size Range: 9
BusinessClosedDtStringIf 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/2025).
TaxWHDetailsObjectObject that contains information about total tax withheld reported to the North Carolina Department for the tax year
L1JanNumberTotal tax withheld reported to the North Carolina Department for the month of January.
Size Range: 0-99999999.99
L2FebNumberTotal tax withheld reported to the North Carolina Department for the month of February.
Size Range: 0-99999999.99
L3MarNumberTotal tax withheld reported to the North Carolina Department for the month of March.
Size Range: 0-99999999.99
L4AprNumberTotal tax withheld reported to the North Carolina Department for the month of April.
Size Range: 0-99999999.99
L5MayNumberTotal tax withheld reported to the North Carolina Department for the month of May.
Size Range: 0-99999999.99
L6JunNumberTotal tax withheld reported to the North Carolina Department for the month of June.
Size Range: 0-99999999.99
L7JulNumberTotal tax withheld reported to the North Carolina Department for the month of July.
Size Range: 0-99999999.99
L7AugNumberTotal tax withheld reported to the North Carolina Department for the month of August.
Size Range: 0-99999999.99
L8SepNumberTotal tax withheld reported to the North Carolina Department for the month of September.
Size Range: 0-99999999.99
L10OctNumberTotal tax withheld reported to the North Carolina Department for the month of October.
Size Range: 0-99999999.99
L11NovNumberTotal tax withheld reported to the North Carolina Department for the month of November.
Size Range: 0-99999999.99
L12DecNumberTotal tax withheld reported to the North Carolina Department for the month of December.
Size Range: 0-99999999.99
L13TotTaxWHNumberTotal tax withheld reported to the North Carolina Department for all the months of the tax year.
Size Range: 0-99999999.99
L14TaxWHRepW2NumberTax Withheld as Reported on W-2 Statements
Size Range: 0-99999999.99
L15TaxWHRep1099NumberTax Withheld as Reported on 1099 Statements
Size Range: 0-99999999.99
L16TotTaxWHNumberTotal Tax Withheld as Reported to the Department of North Carolina
Size Range: 0-99999999.99
L17TotTaxWHRepW21099NumberTotal Tax Withheld as Reported on W-2 and 1099 Statements
Size Range: 0-99999999.99
L18OverPaymentNumberOverpayment 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.
*Size Range: 0-99999999.99
L19AddnlTaxDueNumberAdditional 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
*Size Range: 0-99999999.99
L20InterestAmtNumberInterest amount for the tax year.
Size Range: 0-99999999.99
L21Penaltiesobjectobject that contains Informational Return Penalties details.
L21aLateFilingNumberPenalty imposed, if any, for failure to file by the due date
Size Range: 0-99999999.99
L21bFilingFormatNumberPenalty imposed, if any, for failure to File in Format
Size Range: 0-99999999.99
L21cTotPenaltiesNumberTotal penalties imposed for the tax year
Size Range: 0-99999999.99
L22RefundAmtNumberAmount of Refund Requested for the tax year.
Size Range: 0-99999999.99
L23TotAmtDueNumberTotal Amount Due for the tax year
Size Range: 0-99999999.99
StatePaymentObjectObject that contains information about payment details for the department of North Carolina
AccountTypeStringType of the bank account.
Allowed values

"PERSONAL_CHECKING", "PERSONAL_SAVINGS", "BUSINESS_SAVINGS", "BUSINESS_CHECKING"

BankRoutingNumStringBank routing number
Size Range: 9
BankAccountNumStringBank Account Number
Size Range: ..17
PaymentAmtNumberAmount to be paid to the department of North Carolina
Size Range: 0-99999999.99

Request Params​

"Statefilings/NC3ANNUALRECON/Get?SubmissionId=0199e6d1-cea0-706d-8926-d7dad88478d3&RecordId=0199e6d1-cf7f-747f-afcb-0e489e5ba294"

Response JSON​

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

{
  "StatusCode": "200",
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "019c74aa-c3c0-75d9-b2e9-99c598afd56a",
  "StateWHRecords": [
      {
          "Sequence": "001",
          "RecordId": "019c74aa-c4a3-7114-acf4-c8fa2e2b1fc8",
          "ReturnHeader": {
              "Qtr": "Q4",
              "TaxYr": "2025",
              "Business": {
                  "BusinessId": "7da5863e-6ddf-4e31-ae09-f510260d30db",
                  "BusinessNm": "SnowDaze LLC",
                  "PayerRef": null,
                  "FirstNm": null,
                  "MiddleNm": null,
                  "LastNm": null,
                  "Suffix": null,
                  "TradeNm": null,
                  "IsEIN": true,
                  "EINorSSN": "73-7863412",
                  "Email": "john@sample.com",
                  "ContactNm": null,
                  "Phone": null,
                  "PhoneExtn": null,
                  "Fax": null,
                  "BusinessType": "ESTE",
                  "SigningAuthority": {
                      "Name": "James Smith",
                      "Phone": "(993) 456-7890",
                      "BusinessMemberType": "ADMINISTRATOR"
                  },
                  "KindOfEmployer": null,
                  "KindOfPayer": null,
                  "IsBusinessTerminated": false,
                  "IsForeign": false,
                  "USAddress": {
                      "Address1": "12 main st",
                      "Address2": null,
                      "City": "Rock Hill",
                      "State": "SC",
                      "ZipCd": "29730"
                  },
                  "ForeignAddress": null,
                  "ACADetails": null
              }
          },
          "ReturnData": {
              "FormNC3": {
                  "WHIdNum": "173566979",
                  "BusinessClosedDt": null,
                  "TaxWHDetails": {
                      "L1Jan": 100,
                      "L2Feb": 100,
                      "L3Mar": 100,
                      "L4Apr": 100,
                      "L5May": 100,
                      "L6Jun": 100,
                      "L7Jul": 100,
                      "L8Aug": 100,
                      "L9Sep": 100,
                      "L10Oct": 100,
                      "L11Nov": 100,
                      "L12Dec": 100
                  },
                  "L13TotTaxWH": 1200,
                  "L14TaxWHRepW2": 1000,
                  "L15TaxWHRep1099": 200,
                  "L16TotTaxWH": 1200,
                  "L17TotTaxWHRepW21099": 1200,
                  "L18OverPayment": 0,
                  "L19AddnlTaxDue": 0,
                  "L20InterestAmt": 0,
                  "L21Penalties": {
                      "L21aLateFiling": 20,
                      "L21bFilingFormat": 0,
                      "L21cTotPenalties": 20
                  },
                  "L22RefundAmt": 0,
                  "L23TotAmtDue": 20
              },
              "StatePayment": {
                  "BankRoutingNum": "217555555",
                  "BankAccountNum": "00133",
                  "PaymentAmt": 100,
                  "AccountType": "PERSONAL_CHECKING"
              }
          }
      }
  ],
  "Errors": null
}