Skip to content

FousVirginia Tax Business Online Services

Get your Virginia Tax business account through an API

Read the filed returns on your Account Summary tab, your payments and the letters Virginia Tax sent you, with one API call each. Or have a workflow check after the 20th that last month's ST-1 is filed, and email you each new letter every morning.

Works with your own Virginia Tax Business Online Services account. Fous is an independent product.

What you can build on Virginia Tax

  • Get filing history

    Build this

    Reads the filed returns for one tax account on the Account Summary tab, such as Sales and Use or Withholding, for up to the last 3 years.

    Takes
    Tax account, from period (optional)
    Returns
    Tax type, form, filing period, filed date, tax due, amount paid, amended or original
  • Get letters from Virginia Tax

    Build this

    Reads the copies of notices, letters and correspondence Virginia Tax sent to your Business Account, with the date and the tax account each one is about.

    Takes
    Sent since (optional)
    Returns
    Letter date, title, tax account, period, amount due if any, document link
  • Get payment history

    Build this

    Reads the payment history of your Business Account: the payments made and scheduled for each tax account, with their dates and amounts.

    Takes
    Tax account (optional), since date (optional)
    Returns
    Tax account, filing period, payment date, amount, payment method, status, confirmation number
  • File a VA-5 withholding return

    Build this

    Files a monthly or quarterly VA-5 employer withholding return for one period in the Withholding account, with its payment, and returns the confirmation.

    Takes
    Filing period, Virginia income tax withheld, payment date, bank account
    Returns
    Form, filing period, tax due, payment amount, confirmation number

Automate Virginia Tax with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

  • New letters from Virginia Tax, every morning

    Build this
    Starts
    Every weekday at 8:00
    Step 1
    Get the letters Virginia Tax sent to your Business Account.
    Step 2
    Keep the letters that were not there on the last run.
    Step 3
    Email you each one with its date, title, tax account, period and any amount due.
  • Sales and use tax returns filed for last month

    Build this
    Starts
    Monthly on the 21st at 9:00, the day after ST-1 returns are due
    Step 1
    Get the filing history of the Sales and Use account on the Account Summary tab.
    Step 2
    Keep the result only if no ST-1 return shows for last month's filing period.
    Step 3
    Email you the missing period, or stop when the return is there.
  • Tax payments handed to accounting

    Build this
    Starts
    Monthly on the 26th at 10:00, after VA-5 returns are due on the 25th
    Step 1
    Get the payment history for every tax account in your Business Account.
    Step 2
    Keep the payments that were not there on the last run.
    Step 3
    Post tax account, period, payment date, amount and confirmation number to your accounting system's webhook.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get filing history” would look like.

Example request
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "account.tax.virginia.gov/get_filing_history",
    "input": {
      "tax_account": "Sales and Use",
      "from_period": "2026-07"
    }
  }'
Example response
{
  "status": "completed",
  "data": {
    "business": "Northwind Supply LLC",
    "tax_account": "Sales and Use",
    "returns": [
      {
        "form": "ST-1",
        "filing_period": "2026-09",
        "filed_date": "2026-10-16",
        "tax_due": 4812.36,
        "amount_paid": 4812.36,
        "type": "Original"
      }
    ],
    "count": 1
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

Virginia Tax’s own options

Virginia Tax lists no API for reading a Business Account. Its machine channel is Web Upload, a file-based system for sales and withholding returns, payments and W-2 or 1099 data, with a server-to-server option for high-volume filers. Letters, filing history and payments are read in the account itself.

OptionWhat it coversWhat it takes
Web UploadFiles and pays ST-1, VA-5, VA-15, VA-16 and VA-6 returns and submits W-2 and 1099 data, for many clients or periods in one file.Registration and a Web Upload login. Excel, fixed-width or delimited files, laid out per form.
Web Upload server-to-serverYour server exchanges return and payment files directly with Virginia Tax's server, for companies filing for a high volume of customers.The Server-to-Server box ticked at registration and your server's external IP address. A login follows in 10 to 15 business days.
eFormsFillable return forms, including the ST-1, and withholding forms for a small number of employees.No login needed. One form filled in at a time.
The Business Account by handSales, withholding, vending machine, digital media and tire recycling returns and payments, 3 years of filing history, and copies of letters.An Online Services account. Copies of letters need a full access user.

Read on November 12, 2026: Web Upload, Online Services help, Online Services FAQs.

Signing in to Virginia Tax

Virginia Tax Online Services asks for your username and password, then a second step every time you log in: a passkey, an authentication app, a text or an email. One login manages several tax accounts. With Fous you sign in once through the site's own sign-in with your own account: the login is sealed with AES-256, an emailed code is handled, and an expired session is signed back in.

Worth knowing

Two platforms during the move
Sales and use, withholding, vending machine, digital media and tire recycling fees are on the new Online Services platform. Other business taxes stay on the older business account, paid with Web Payment.
The old account no longer files sales tax
After November 9 the older account no longer files or pays sales and withholding taxes, though you can still sign in to it. Build methods for those taxes on account.tax.virginia.gov.
Three years of history, letters for full access
The new platform shows filing history for the last 3 years. Copies of letters are visible only to a full access user, so sign in with an account that has that access.
A new Company ID for debit blocks
If your bank blocks ACH debits, add Virginia Tax's new Company ID 5546001745 to the debits your bank allows.

More in Government: US state and local tax

Other industries: GDOL Employer Portal, Motion, e-staffing, ABC Order, Covered California Enroller Portal, Collaborati.

Frequently asked questions

No API for reading an account is listed. Virginia Tax offers Web Upload, a file-based system for bulk returns, payments and W-2 or 1099 data, with a server-to-server option for high-volume filers, and eForms for single returns. Letters, filing history and payments are read in the Business Account itself.

Yes, you can still sign in to it during the transition. After November 9 it no longer files or pays sales and withholding taxes, which move to the new Online Services platform. Other business taxes are still paid in the older account with Web Payment.

The new platform shows filing history for the last 3 years. You see the filed returns on the Account Summary tab, and from the same section you file an amended return.

The ST-1 is due on the 20th of the month after the filing period. A monthly VA-5 is due on the 25th of the following month, and a quarterly VA-5 on the last day of the month after the quarter. Both must be filed and paid electronically.

No. Fous is an independent product. You use it with your own Virginia Tax Online Services account, and a method reads and does only what that account can.

Put Virginia Tax Business Online Services behind an API call

Describe one job in Studio and see the method it builds, with 100 credits a month and no credit card, or book a demo and bring the sites your team signs in to.

Read nextWisconsin My Tax AccountOhio Business GatewayMyFTBGDOL Employer PortalHow methods workHow workflows run

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Virginia Tax Business Online Services (Virginia Department of Taxation). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.