Version: 2.0.0

Get

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

GET statefilings/vaui/get

Run in Postman

Request Body

Field	Type	Description
SubmissionId	Guid	Unique identifier of a submission.
RecordId	Guid	Optional An unique identifier generated by TaxBandits when a FC2021 return is created. Mention the return's Record ID that you want to get.

Response Body

Field	Type	Description
SubmissionId	Guid	Unique identifier created by TaxBandits for each submission.
StateUIRecords	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 FC 20-21 is to be filed.
Qtr	String	The quarter for which the Form FC 20-21 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	The 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.
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	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.
ReturnData	Object	Contains the return information.
BusinessType	String	Legal structure of the business.
SigningAuthority	Object	Details of the person authorized to sign the return. Mandatory for 94x forms.
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	Contains the return information.
FormFC2021	Object	Identifies the Form FC 20-21 data.
UIIdNumber	String	Employer's Virginia Unemployment Account Number. Size Range: 10 digits Allowed values 00######## or 000#######
IsNoWageReported	Boolean	When true, indicates that no wage is reported in this quarter.
TotalGrossWages	Number	Total gross wages reported for all employees for the quarter.
TotalTaxableWages	Number	Total taxable wages reported for all employees for the quarter.
TotalExcessWages	Number	Total excess wages reported for all employees for the quarter.
UITaxRate	Number	Tax rate for the quarter.
UITaxDue	Number	Unemployment insurance tax due for the reported taxable wages.
Interest	Number	Interest for the quarter.
Penalty	Number	Penalty for the quarter.
TotalUITaxDue	Number	Total unemployment insurance tax due for the quarter.
NumberOfEmployees	Object	Identifies the total number of employees for the quarter.
TotalMonth1Employees	string	Total number of employees in month 1 of the quarter.
TotalMonth2Employees	string	Total number of employees in month 2 of the quarter.
TotalMonth3Employees	string	Total number of employees in month 3 of the quarter.
EmployeeDetails	Object	Object to identify the employee details.
EmployeeSequenceId	string	A unique number to identify this record.
EmployeeId	Guid	A unique ID generated by TaxBandits after the return is created and returned in the response.
EmployeeRef	string	User-provided employee reference identifier
SSN	string	Employee's Social Security Number (SSN).
FirstNm	string	Employee's first name.
MiddleNm	string	Employee's middle name.
LastNm	string	Employee's last name.
Suffix	string	Employee's suffix.
Address	object[]	Address information of the Employee.
Address1	string	Street address or PO Box. Size Range: 46
Address2	string	Optional Suite or apartment number. Size Range: 46
City	string	Employee's city. Size Range: 50
ProvinceOrState	string	Employee'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	Employee's ZIP code. Size Range: 5-16
Country	string	Employee'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"
GrossWages	Number	Total gross wages paid to the employee during the reporting quarter.
Errors	Object[]	Shows detailed error information.
Id	string	Total due amount.
Name	string	Name of the validation error.
Message	string	Description of the validation error.

Request JSON

"statefilings/VAUI/Get?RecordId=f5c0b155-7261-4f9d-b0bc-cad7a0f69d2e&SubmissionId=01993c45-e77e-7383-823a-d13273fd717c"

Response JSON

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

{
"SubmissionId": "01a167c6-ab4e-7347-ad84-ccb5e6e4b7c7",
"StateUIRecords": [
  {
    "SequenceId": "001",
    "RecordId": "01a167c6-bd00-77d8-ac28-6c38091ceaf4",
    "ReturnHeader": {
      "Qtr": "Q3",
      "TaxYear": "2026",
      "Business": {
        "BusinessId": "42ba5f00-c86c-4dd5-af96-88007a5e455b",
        "PayerRef": null,
        "IsDefaultBusiness": true,
        "TINDetails": {
          "Format": "PLAIN_TIN",
          "TINType": "EIN",
          "TIN": "26-6108431"
        },
        "BusinessNm": "Snowdaze LLC",
        "DBADetails": {
          "DBANm": "Iceberg Icecreams",
          "DBARef": "DBA1001",
          "DBAId": "F523893E-DAFD-489A-909E-F4CE15C24646",
          "Address": {
            "Address1": "123 Main St",
            "Address2": "Suite 100",
            "City": "Richmond",
            "ProvinceOrState": "VA",
            "ZipCd": "23219",
            "Country": "US"
          }
        },
        "Address": {
          "Address1": "456 Market St",
          "Address2": "Suite 200",
          "City": "Virginia Beach",
          "ProvinceOrState": "VA",
          "ZipCd": "23451",
          "Country": "US"
        },
        "ContactDetails": {
          "FirstNm": "James",
          "MiddleNm": "A",
          "LastNm": "Anderson",
          "Suffix": "Jr",
          "Phone": "(564) 650-1651",
          "PhoneExtn": "101",
          "Email": "contact@snowdaze.com",
          "Fax": "(803) 555-5678"
        },
        "BusinessType": "PART",
        "SigningAuthority": {
          "FirstNm": "Ambrane",
          "MiddleNm": "A",
          "LastNm": "Cavil",
          "Suffix": "",
          "Phone": "(803) 555-1000",
          "PhoneExtn": "111",
          "BusinessMemberType": "OWNER"
        }
      }
    },
    "ReturnData": {
      "FormFC2021": {
        "UIIdNumber": "0089304997",
        "IsNoWageReported": false,
        "TotalGrossWages": 30000,
        "TotalExcessWages": 9000,
        "TotalTaxableWages": 21000,
        "UITaxRate": "2.5",
        "UITaxDue": 525,
        "Penalty": 20.22,
        "Interest": 20.32,
        "TotalUITaxDue": 565.54,
        "NumberOfEmployees": {
          "TotalMonth1Employees": 3,
          "TotalMonth2Employees": 3,
          "TotalMonth3Employees": 3
        },
        "EmployeeDetails": [
          {
            "EmployeeSequenceId": "01",
            "EmployeeId": "e450c223-d62b-42a1-b883-a7bf9e9ab547",
            "EmployeeRef": null,
            "SSN": "001-45-6924",
            "FirstNm": "John",
            "MiddleNm": "A",
            "LastNm": "Smith",
            "Suffix": "Sr",
            "Address": {
              "Address1": "789 Broad St",
              "Address2": "Suite 300",
              "City": "Roanoke",
              "ProvinceOrState": "VA",
              "ZipCd": "24011",
              "Country": "US"
            },
            "GrossWages": 10000
          },
          {
            "EmployeeSequenceId": "02",
            "EmployeeId": "0f8c11be-c2d5-4d3b-9499-16a10dffbf1b",
            "EmployeeRef": null,
            "SSN": "001-45-6900",
            "FirstNm": "roger",
            "MiddleNm": "J",
            "LastNm": "peter",
            "Suffix": "Jr",
            "Address": {
              "Address1": "321 King St",
              "Address2": "Suite 400",
              "City": "Alexandria",
              "ProvinceOrState": "VA",
              "ZipCd": "22314",
              "Country": "US"
            },
            "GrossWages": 10000
          },
          {
            "EmployeeSequenceId": "03",
            "EmployeeId": "fa2e473a-f7bd-4583-8c76-65b590f03515",
            "EmployeeRef": null,
            "SSN": "001-45-6220",
            "FirstNm": "Elise",
            "MiddleNm": "J",
            "LastNm": "Sullivan",
            "Suffix": null,
            "Address": {
              "Address1": "654 Main St",
              "Address2": "Suite 500",
              "City": "Charlottesville",
              "ProvinceOrState": "VA",
              "ZipCd": "22902",
              "Country": "US"
            },
            "GrossWages": 10000
          }
        ]
      }
    }
  }
],
"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

Get

Get

Request Body

Response Body

Request JSON​

Response JSON​

Request JSON

Response JSON