Version: 2.0.0

Update

Use this endpoint to update the information on existing NC-3 forms that are already created for a specific payer.

You cannot update a return once it has been transmitted.

PUT StateFilings/NC3ANNUALRECON/Update

Run in Postman

Request Body

Field	Type	Description
SubmissionId	Guid	Unique identifier created by TaxBandits for each submission. Not required when you are creating a return.
StateWHRecords	Object[]	Object to create NC-3
SequenceId	String	A unique number given by an inbound application to identify failed records. Size Range: ..50
ReturnHeader	Object	Identifies the supporting details of Form NC-3.
TaxYear	String	The tax year for which Form NC-3 needs to be filed. Allowed values 2025,2026
Qtr	String	The 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.
Business	object	Object to identify the Business Details.
BusinessId	Guid	Optional Use the unique Business ID (Generated by TaxBandits) that you received in the response of the Business CREATE Endpoint. If you do not have a Business ID, ignore the field. By giving the Business ID, you do not have to provide all the business information again.
PayerRef	string	Optional Your unique identifier for the payer. Can replace BusinessId in future requests. Size Range: 50
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. Allowed values "PLAIN_TIN" — Pass TIN directly. "TOKENIZED_TIN" — Pass tokenized TIN.
TINType	string	Specify the TIN type of the business. Allowed values "EIN", "SSN", "QI-EIN", "ITIN", "WP-EIN", "WT-EIN", "NQI-EIN", "IRSN"
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. Size Range: 20
MiddleNm	string	Optional Middle name of the individual. Size Range: 20
LastNm	string	The last name of the individual. Size Range: 20
Suffix	string	Optional Suffix of the individual's name. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
BusinessNm	string	Legal name of the business. Required when TINType is EIN. Size Range: 75
NameCtrl	string	Name control of the business as registered with the IRS. Size Range: 3..4
DBADetails	object[]	Optional DBA (Doing Business As) information.
DBANm	string	Name of the DBA. Size Range: 75
DBARef	string	Unique identifier for the DBA. Size Range: 1-50
DBAId	Guid	TaxBandits-generated DBA identifier.
Address	object[]	Address information of the DBA.
Address1	string	Street address or PO Box. Size Range: 46
Address2	string	Optional Suite or apartment number. Size Range: 46
City	string	DBA's city. Size Range: 50
ProvinceOrState	string	DBA's province or state name. When the country code is US: 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" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
Zipcd	string	DBA's ZIP code. Size Range: 5-16
Country	string	DBA's 2-character country code. Allowed values "US","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"
Email	string	Optional Email address of the Business. Size Range: ..100
Address	object	Primary address of the business.
Address1	string	Street address or PO Box of the business. Size Range: 46
Address2	string	Optional Suite or apartment number of the business. Size Range: 46
City	string	City of the business. Size Range: 50
ProvinceOrState	string	Province or state name of the business. When the country code is US: 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" When the country code is CA: Allowed values "AB", "BC", "MB", "NB", "NL", "NT", "NS", "NU", "ON", "PE", "QC", "SK", "YT" Note: The size range is set to 50 for all countries except the United States and Canada.
ZipCd	string	ZIP code of the business. Size Range: 5-16
Country	string	2-character country code of the business. Allowed values "US","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"
ContactDetails	object[]	Details of the person the IRS can contact regarding the given business.
FirstNm	string	First name of the contact person. Size Range: 20
MiddleNm	string	Optional Middle name of the contact person. Size Range: 20
LastNm	string	Last name of the contact person. Size Range: 20
Suffix	string	Optional The suffix of the contact person. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
Phone	string	Optional Phone number of the contact person. Size Range: 10 digits
PhoneExtn	string	Optional Phone extension number. Size Range: 5
Email	string	Optional Email address of the contact person. Size Range: ..100
Fax	string	Optional Fax number of the contact person. Size Range: 10 digits
SigningAuthority	Object	Details of the person authorized to sign the return.
FirstNm	String	First name of the signatory. Size Range: 20
MiddleNm	String	Optional Middle name of the signatory. Size Range: 20
LastNm	String	Last name of the signatory. Size Range: 20
Suffix	String	Optional The suffix of the signatory. Allowed values "Jr", "Sr", "I", "II", "III", "IV", "V", "VI", "VII"
Phone	String	Optional Phone number of the signatory. Size Range: 10 digits
PhoneExtn	String	Optional Phone extension number of the signatory. Size Range: 5
BusinessMemberType	String	Optional Title or role of the signatory. 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", "REPORTINGAGENT"
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. Size Range: 9
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. Size Range: 0-99999999.99
Feb	Number	Total tax withheld reported to the North Carolina Department for the month of February. Size Range: 0-99999999.99
Mar	Number	Total tax withheld reported to the North Carolina Department for the month of March. Size Range: 0-99999999.99
Apr	Number	Total tax withheld reported to the North Carolina Department for the month of April. Size Range: 0-99999999.99
May	Number	Total tax withheld reported to the North Carolina Department for the month of May. Size Range: 0-99999999.99
Jun	Number	Total tax withheld reported to the North Carolina Department for the month of June. Size Range: 0-99999999.99
Jul	Number	Total tax withheld reported to the North Carolina Department for the month of July. Size Range: 0-99999999.99
Aug	Number	Total tax withheld reported to the North Carolina Department for the month of August. Size Range: 0-99999999.99
Sep	Number	Total tax withheld reported to the North Carolina Department for the month of September. Size Range: 0-99999999.99
Oct	Number	Total tax withheld reported to the North Carolina Department for the month of October. Size Range: 0-99999999.99
Nov	Number	Total tax withheld reported to the North Carolina Department for the month of November. Size Range: 0-99999999.99
Dec	Number	Total tax withheld reported to the North Carolina Department for the month of December. Size Range: 0-99999999.99
TotTaxWH	Number	Total tax withheld reported to the North Carolina Department for all the months of the tax year. Size Range: 0-99999999.99
TaxWHW2	Number	Tax Withheld as Reported on W-2 Statements Size Range: 0-99999999.99
TaxWH1099	Number	Tax Withheld as Reported on 1099 Statements Size Range: 0-99999999.99
TotTaxWHRep	Number	Total Tax Withheld as Reported to the Department of North Carolina Size Range: 0-99999999.99
TotTaxRep	Number	Total Tax Withheld as Reported on W-2 and 1099 Statements Size Range: 0-99999999.99
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. Size Range: 0-99999999.99
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 Size Range: 0-99999999.99
Interest	Number	Interest amount for the tax year. Size Range: 0-99999999.99
Penalty	object	object that contains Informational Return Penalties details.
LateFilingPenalty	Number	Penalty imposed, if any, for failure to file by the due date Size Range: 0-99999999.99
LateRepPenalty	Number	Penalty imposed, if any, for failure to File in Format Size Range: 0-99999999.99
TotPenalties	Number	Total penalties imposed for the tax year Size Range: 0-99999999.99
Refund	Number	Amount of Refund Requested for the tax year. Size Range: 0-99999999.99
BalanceDue	Number	Total Amount Due for the tax year Size Range: 0-99999999.99
StatePayment	Object	Object that contains information about payment details for the department of North Carolina
AccountType	String	Type of the bank account. Allowed values "PERSONAL_CHECKING", "PERSONAL_SAVINGS", "BUSINESS_SAVINGS", "BUSINESS_CHECKING"
BankRoutingNum	String	Bank routing number Size Range: 9
BankAccountNum	String	Bank Account Number Size Range: ..17
PaymentAmt	Number	Amount to be paid to the department of North Carolina Size Range: 0-99999999.99

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission
SuccessRecords	object[]	It will show the detailed information about the success status of Form NC-3 Records
SequenceId	string	A unique number given by an inbound application to identify particular records.
BusinessId	Guid	Unique identifier of a Business
PayerRef	string	Unique identifier of the payer
RecordId	Guid	An unique identifier generated by TaxBandits when a NC-3 return is created
FormType	string	Denotes the type of withholding form (Form NC-3).
Status	string	Returns the record status of the return.
StatusTs	string	Date and time of the return created.
Info	string	Returns the information about the return
Errors	object[]	Displays error information related to the state returns of Form NC-3.
Id	string	Returns the validation error ID.
Name	string	Name of the validation error.
ErrorRecords	object[]	Provides detailed information about the error status of Form NC-3 records.
SequenceId	string	A unique reference ID for the submission that can be used to identify a particular record. The Sequence ID will be returned in the response for your reference.
RecordId	Guid	Unique identifier for the record.
Errors	object[]	Displays 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

Sample 1

{
"SubmissionId": "01a0e790-7d93-77cf-8bb8-ec0638ee297f",
"StateWHRecords": [
  {
    "SequenceId": "001",
    "RecordId": "01a0e790-7f65-74b0-a64a-6972eac60431",
    "ReturnHeader": {
      "Qtr": "Q4",
      "TaxYear": "2025",
      "Business": {
        "BusinessId": null,
        "PayerRef": null,
        "IsDefaultBusiness": true,
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "15-9811483"
        },
        "IndividualNm": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr"
        },
        "BusinessNm": "Snowdaze LLC",
        "NameCtrl": "FIRE",
        "DBADetails": {
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "DBAId": null,
          "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": "8035551234",
          "PhoneExtn": "101",
          "Email": "contact@snowdaze.com",
          "Fax": "8035555678"
        },
        "BusinessType": "ESTE",
        "SigningAuthority": {
          "FirstNm": "Ambrane",
          "MiddleNm": "A",
          "LastNm": "Cavil",
          "Suffix": "Jr",
          "Phone": "8035551000",
          "PhoneExtn": "111",
          "BusinessMemberType": "ADMINISTRATOR"
        }
      }
    },
    "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": 0,
          "LatePenPenalty": 0,
          "TotPenalties": 0
        },
        "Refund": 0,
        "BalanceDue": 0
      },
      "StatePayment": {
        "AccountType": "PERSONAL_CHECKING",
        "BankRoutingNum": "217555555",
        "BankAccountNum": "00133",
        "PaymentAmt": 100
      }
    }
  }
]
}

Response JSON

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

{
  "SubmissionId": "01a0e790-7d93-77cf-8bb8-ec0638ee297f",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "2c142376-22db-4e67-835e-f31af93de1b1",
          "PayerRef": null,
          "RecordId": "01a0e790-7f65-74b0-a64a-6972eac60431",
          "FormType": "NC3",
          "Status": "CREATED",
          "StatusTs": "2026-09-28 06:30:56 -04:00",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}

W-9/W-8 Automation

1099 Automation

TIN Matching

W-2 Automation

941/940 Automation

1098-T Automation

ACA Automation

Extension Automation

1042-S Automation

Supported Forms

Gig Software

Payroll Software

Affiliate Software

HOA Software

Reselling Platform

HCM Providers

Property Management

Healthcare Market Research Platforms

Update

Update

Request Body

Response Body

Request JSON​

Response JSON​

Request JSON

Response JSON