Skip to main content
Version: 1.7.3

Create

Create

Use this endpoint to generate a new withholding form for the state of Virginia.

VA-5Q (Quarterly Form):​

  • Used for reporting state withholding taxes on a quarterly basis.

  • Employers who withhold Virginia state income tax from employee wages and are not required to file monthly use this form.

  • Covers the tax period of 3 months (quarterly).

POST StateFilings/VA5QWH/Create
Run in Postman

Request Body

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

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

TaxYrStringThe tax year for which Form VA-5Q 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
ReturnDataObject[]Identifies the Form VA-5Q data.
FormVA5QObjectVirginia withholding quarterly tax return.
WHIdNumStringVirginia withholding account number.
Allowed Format: "30-999999999F-001" or "30999999999F001"
L1VAWHAmtNumberTotal Virginia income tax withheld for the quarter
Size Range: 0-99999999.99
IsL1OverPaymentBooleanIf True identifies that Adjustment is made for the over payment reporting
IsL2UnderPaymentBooleanIf True identifies that Adjustment is made for the under payment reporting
L2AdjAmtNumberPrevious period(s) adjustments
Size Range: 0-99999999.99
L3TotAdjAmtNumberTotal adjustment totals of the quarter
Size Range: 0-99999999.99
L4PenaltyAmtNumberPenalties for the quarter
Size Range: 0-99999999.99
L5InterestAmtNumberTotal interest amount for the quarter
Size Range: 0-99999999.99
L6TotAmtDueNumberTotal amount due for the quarter
Size Range: 0-99999999.99
StatePaymentObjectObject to identify the state payment details
RoutingTransitNumberStringBank routing number for state payment
Size Range: 9
BankAccountNumberStringBank account number for state payment
Size Range: ..17
PaymentAmtNumberPayment amount for state payment
Size Range: 0-99999999.99

Response Body

FieldTypeDescription
SubmissionIdGuidUnique identifier of a submission
SuccessRecordsobject[]It will show the detailed information about the success status of Form VA-5Q Records
SequenceIdstringA unique number given by an inbound application to identify particular records.
BusinessIdGuidUnique identifier of a Business
PayerRefstringUnique identifier of the payer
RecordIdGuidAn unique identifier generated by TaxBandits when a VA-5Q return is created
FormTypestringDenotes the type of withholding form (Form VA-5Q).
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 VA-5Q
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 VA-5Q Records.
SequenceIdstringA unique number given by an inbound application to identify particular records. 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​

{
    "StateWHRecords": [
        {
            "Sequence": "001",
            "ReturnHeader": {
                "Qtr": "Q4",
                "TaxYr": "2025",
                "Business": {
                    "BusinessId": null,
                    "BusinessNm": "SnowDaze LLC",
                    "PayerRef": null,
                    "FirstNm": null,
                    "MiddleNm": null,
                    "LastNm": null,
                    "Suffix": null,
                    "TradeNm": "",
                    "IsEIN": true,
                    "EINorSSN": "34-2093733",
                    "Email": "john@sample.com",
                    "ContactNm": null,
                    "Phone": null,
                    "PhoneExtn": null,
                    "Fax": null,
                    "BusinessType": "ESTE",
                    "SigningAuthority": {
                        "Name": "James Smith",
                        "Phone": "9934567890",
                        "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": {
                "FormVA5Q": {
                    "WHIdNum": "30-342093733F-001",
                    "L1VAWHAmt": 300,
                    "L2AdjAmt": 200,
                    "IsL2OverPayment": true,
                    "IsL2UnderPayment": false,
                    "L3TotAdjAmt": 500,
                    "L4PenaltyAmt": 100,
                    "L5InterestAmt": 100,
                    "L6TotAmtDue": 700
                },
                "StatePayment": {
                    "BankRoutingNum": "217555555",
                    "BankAccountNum": "0000000001",
                    "PaymentAmt": 100
                }
            }
        }
    ]
}

Response JSON​

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

{
  "StatusCode": "200",
  "StatusName": "Ok",
  "StatusMessage": "Successful API call",
  "SubmissionId": "0199e6f0-2c54-752a-a1a4-efe2be1e13a6",
  "SuccessRecords": [
      {
          "SequenceId": "001",
          "BusinessId": "136f3b7f-4734-42be-894c-dc7c68258ea7",
          "PayerRef": null,
          "RecordId": "0199e6f0-2d46-7068-bb26-ba57f29784f5",
          "FormType": "VA5Q",
          "Status": "CREATED",
          "StatusTs": "2025-10-15 04:15:23 -04:00",
          "Info": null,
          "Errors": null
      }
  ],
  "ErrorRecords": null,
  "Errors": null
}