Skip to main content
Version: 1.7.3

Create

Create

Use this endpoint to generate a new withholding form for the state of South Carolina. There are two withholding forms available: Form 1605 and Form 1606, but they apply under different circumstances:

  • Form 1605: Use this form to report tax withholding for the first three quarters of the tax year.
  • Form 1606: Use this form to report tax withholding for the last quarter of the tax year or for annual reconciliation.
POST StateFilings/SCWH/Create
Run in Postman

Request Body

FieldTypeDescription
StateWHRecordsObject[]Object to create Form 1605/1606
SequenceIdStringA unique number given by an inbound application to identify failed records. 
Size Range: ..10
ReturnHeaderObjectIdentifies the supporting details of Form 1605 or Form 1606.
QtrStringThe quarter for which Form 1605 or Form 1606 needs to be filed.
For 1605
Allowed values

"Q1", "Q2", "Q3"

For 1606
Allowed values

"Q4"

TaxYrStringThe tax year for which Form 1605 or Form 1606 needs to be filed.
Allowed values

"2025"

BusinessObjectThe details of the business you’re filing for.
BusinessNmStringName of the business. 
Size Range: ..75
PayerRefstringOptional An unique identifier for each payer completing their information. This identifier can be used in future references of the payer in the API.
Size Range: ..50
TradeNmStringOptional Name under which the business operates.
Size Range: ..75
IsEINBooleanWhen true, identifies the business with an EIN.
EINorSSNStringWhen IsEIN is true, use Employer Identification Number (EIN).
Size Range: 9-11
EmailStringEmail address of the business.
Size Range: ..100
IsForeignBooleanWhen true, identifies the business as having a foreign address.
USAddressObjectIf IsForeign is false, pass the US address of the business.
Address1StringEmployer/Payer’s US address (street address or post office box).
Size Range: ..46
Address2StringOptional Employer/Payer’s suite or apartment.
Size Range: ..46
CityStringEmployer/Payer’s city.
Size Range: ..50
StateStringEmployer/Payer’s state.
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).
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
ReturnDataObjectIdentifies the Form 1605 or Form 1606 data.
FormSC1605ObjectSouth Carolina withholding tax returns for the first three quarters.
IsChangeOfAddBooleanWhen true, identifies that the payer has changed the address.
IsCloseWHAccBooleanWhen true, identifies that the payer has closed the withholding account.
WHAccCloseDateStringWithholding account closed date. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY (Example: 01/25/2025).
WHIdNumStringSouth Carolina withholding file number.
Size Range: ..9
L1IncomeTaxWHNumberQuarterly South Carolina income tax withheld from all sources.
Size Range: 0-99999999.99
L2IncomeTaxDepositsNumberQuarterly South Carolina income tax deposits or payments made.
Size Range: 0-99999999.99
L3RefundNumberTotal refund (Enter the difference if L2IncomeTaxDeposits is greater than L1IncomeTaxWithheld).
Size Range: 0-99999999.99
L4TaxDueNumberTotal tax due (Enter the difference if L1IncomeTaxWH is greater than L2IncomeTaxDeposits).
Size Range: 0-99999999.99
L5PenaltyNumberTotal penalty amount, if applicable.
Size Range: 0-99999999.99
L5InterestNumberTotal interest due amount, if applicable.
Size Range: 0-99999999.99
L5TotalNumberTotal penalty and interest due amount, if applicable.(L5Penalty + L5Interest).
Size Range: 0-99999999.99
L6BalanceDueNumberTotal balance due amount, if applicable.
Size Range: 0-99999999.99
FormSC1606ObjectSouth Carolina withholding last quarter of the tax year or for annual reconciliation return
IsChangeOfAddBooleanWhen true, identifies that the payer has changed the address.
IsCloseWHAccBooleanWhen true, identifies that the payer has closed the withholding account.
WHAccCloseDateStringWithholding account closed date. Enter the date in the format: MM/DD/YYYY or MM-DD-YYYY (Example: 01/25/2025).
WHIdNumStringSouth Carolina withholding file number.
Size Range: ..9
L1IncomeTaxWHNumberQuarterly South Carolina income tax withheld from all sources.
Size Range: 0-99999999.99
L2IncomeTaxDepositsNumberQuarterly South Carolina income tax deposits or payments made.
Size Range: 0-99999999.99
L3RefundNumberTotal refund (Enter the difference if L2IncomeTaxDeposits is greater than L1IncomeTaxWithheld).
Size Range: 0-99999999.99
L4TaxDueNumberTotal tax due (Enter the difference if L1IncomeTaxWH is greater than L2IncomeTaxDeposits).
Size Range: 0-99999999.99
L5PenaltyNumberTotal penalty amount, if applicable.
Size Range: 0-99999999.99
L5InterestNumberTotal interest due amount, if applicable.
Size Range: 0-99999999.99
L5TotalNumberTotal penalty and interest due amount, if applicable.(L5Penalty + L5Interest).
Size Range: 0-99999999.99
L6BalanceDueNumberTotal balance due amount , if applicable.
Size Range: 0-99999999.99
L7JantoMarNumberTotal tax withheld from all sources in Quarter 1 (Jan to Mar).
Size Range: 0-99999999.99
L7AprtoJunNumberTotal tax withheld from all sources in Quarter 2 (Apr to Jun).
Size Range: 0-99999999.99
L7JultoSepNumberTotal tax withheld from all sources in Quarter 3 (Jul to Sep).
Size Range: 0-99999999.99
L7OcttoDecNumberTotal tax withheld from all sources in Quarter 4 (Oct to Dec).
Size Range: 0-99999999.99
L7TotalTaxWHNumberTotal tax withheld from all the quarters (sum of L7JantoMar, L7AprtoJun, L7JultoSep, and L7OcttoDec).
Size Range: 0-99999999.99
L8W2sNumberTotal South Carolina income tax withheld from all quarters reported from W-2 forms.
Size Range: 0-99999999.99
L8W2GsNumberTotal South Carolina income tax withheld from all quarters reported from W-2G forms.
Size Range: 0-99999999.99
L81099sNumberTotal South Carolina income tax withheld from all quarters reported from 1099 forms.
Size Range: 0-99999999.99
L8TotalTaxWHNumberTotal South Carolina income tax withheld from all quarters reported from all W-2, W-2G, and 1099 forms.
Size Range: 0-99999999.99
L9TotalSCIncomeNumberTotal South Carolina income reported in W-2s, W-2Gs, and 1099s.
Size Range: 0-99999999.99
L10NoOfFormsSubmittedNumberTotal number of W-2s, W-2Gs, and 1099s submitted with WH-1612 or online through MyDORWAY.
Size Range: ..6

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission
SuccessRecordsobject[]It will show the detailed information about the success status of Form 1605/1606 Records
SequenceIdstringReturns the unique reference ID for the submission that can be used to identify a particular record
BusinessIdGuidUnique identifier of a Business
PayerRefstringUnique identifier of the payer
RecordIdGuidAn unique identifier generated by TaxBandits when a 1605/1606 return is created
FormTypestringDenotes the type of withholding form (Form 1605 / Form 1606).
StatusstringReturns the record status of return.
StatusTsstringDate and time of the return created.
InfostringReturns the information about the return
Errorsobject[]Shows error information of state returns of Form 1605 / Form 1606
IdstringReturns the validation error Id.
NamestringName of the validation error.
MessagestringDescription of the validation error.
ErrorRecordsobject[]It will show the detailed information about the error status of Form 1605 / Form 1606 Records.
SequenceIdstringAn 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.
RecordIdGuidUnique identifier of a record
Errorsobject[]Shows detailed error information
IdstringReturns the validation error Id
NamestringName of the validation error
MessagestringDescription of the validation error
Errorsobject[]Shows detailed error information.
IdstringReturns the validation error Id.
NamestringName of the validation error.
MessagestringDescription of the validation error.

Request JSON​

Create return for the first three quarters of the tax year

{
  "StateWHRecords": [
      {
          "Sequence": "001",
          "ReturnHeader": {
              "Qtr": "Q1",
              "TaxYr": "2025",
              "Business": {
                  "BusinessId": null,
                  "BusinessNm": "SnowDaze LLC",
                  "PayerRef": null,
                  "TradeNm": "Iceberg Icecreams",
                  "IsEIN": true,
                  "EINorSSN": "76-5667983",
                  "Email": "john@gmail.com",
                  "IsForeign": false,
                  "USAddress": {
                      "Address1": "12 main st",
                      "Address2": null,
                      "City": "Rock Hill",
                      "State": "SC",
                      "ZipCd": "29730"
                  },
                  "ForeignAddress": null
              }
          },
          "ReturnData": {
              "FormSC1605": {
                  "IsChangeOfAdd": true,
                  "IsCloseWHAcc": true,
                  "WHAccCloseDate": "07/23/2025",
                  "WHIdNum": "124588229",
                  "L1IncomeTaxWH": 5000,
                  "L2IncomeTaxDeposits": 6000,
                  "L3Refund": 1000,
                  "L4TaxDue": 0,
                  "L5Penalty": 0,
                  "L5Interest": 0,
                  "L5Total": 0,
                  "L6BalanceDue": 0
              },
              "FormSC1606": null
          }
      }
  ]
}

Response JSON​

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

{
  "StatusCode": "200",
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "01993c3f-bd17-73ad-b4ca-8891c23f3118",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "da40ab7f-e8dc-4091-834b-b564a437c895",
          "PayerRef": null,
          "RecordId": "01993c3f-bdd6-71f0-ac13-27cd4b663571",
          "FormType": "SC1605",
          "Status": "CREATED",
          "StatusTs": "2025-09-12 00:47:14 -04:00",
          "Info": null,
          "Errors": null
      },
      {
          "SequenceId": "002",
          "BusinessId": "df7b1d1b-62c3-4cb0-a564-3958c0bea9cf",
          "PayerRef": null,
          "RecordId": "01993c3f-c322-71d5-ab35-0f70f59d72b2",
          "FormType": "SC1606",
          "Status": "CREATED",
          "StatusTs": "2025-09-12 00:47:15 -04:00",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}