Get your NY Business Online Services filings through an API

What you can build on Online Services

• Get filing history for a tax type

  Build this

  Reads the filing history for one tax type in the Filings and payments section of the Account Summary: returns by filing period, with the forms filed and each status.

  Takes

  Tax type, such as sales tax or withholding tax

  Returns

  Filing period, form, return status, whether an e-filed copy is available

• Get payment history for a tax type

  Build this

  Reads the payment history for one tax type on the Account Summary: payments by filing period, with amount, confirmation number and status.

  Takes

  Tax type, filing period (optional)

  Returns

  Filing period, payment type, amount, confirmation number, status (posted, scheduled, canceled or dishonored)

• List tax types with filings and payments

  Build this

  Reads the tax types listed in the Filings and payments section of the Account Summary, so a workflow can go through each one.

  Takes

  Nothing

  Returns

  Tax type

• Respond to a department notice

  Build this

  Opens Respond to department notice from the Services menu, picks the notice type, enters the assessment ID, case ID or DLN and submits your written response.

  Takes

  Notice type, assessment ID or case ID or DLN, response text (up to 1,000 characters), contact name, daytime phone

  Returns

  Notice type, ID entered, submitted at, confirmation shown on screen

Automate Online Services 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.

• Canceled or dishonored tax payments, every Monday

  Build this

  Starts

  Every Monday at 8:00 New York time

  Step 1

  List the tax types in the Filings and payments section of the Account Summary.

  Step 2

  For each tax type, get the payment history.

  Step 3

  Keep payments whose status changed to canceled or dishonored since the last run.

  Step 4

  Email you each one with tax type, filing period, amount and confirmation number.

• Sales tax and withholding return statuses for accounting

  Build this

  Starts

  Every weekday at 7:00 New York time

  Step 1

  Get the filing history for sales tax and for withholding tax.

  Step 2

  Keep the returns whose status changed since the last run.

  Step 3

  Post tax type, filing period, form and status to your accounting system's webhook.

• Scheduled tax payments, at the start of each month

  Build this

  Starts

  On the 1st of every month at 9:00 New York time

  Step 1

  List the tax types in the Filings and payments section of the Account Summary.

  Step 2

  For each tax type, get the payment history.

  Step 3

  Keep the payments in scheduled status.

  Step 4

  Email you the list with tax type, filing period, amount and confirmation number.

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 for a tax type” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "ols.tax.ny.gov/get_filing_history",
    "input": {
      "tax_type": "Sales tax"
    }
  }'

{
  "status": "completed",
  "data": {
    "business": "Northwind Supply LLC",
    "tax_type": "Sales tax",
    "filings": [
      {
        "filing_period": "2026-06-01 to 2026-08-31",
        "form": "ST-100",
        "status": "Processed",
        "efiled_copy_available": true
      }
    ],
    "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.

Online Services’s own options

The Tax Department lists no API for a business's Online Services account. Sales tax returns are filed only in Online Services through Sales Tax Web File. Withholding returns can also go through approved commercial software or Web Upload, and corporation tax returns through approved commercial software. Filing and payment history, bills and notices are in the account.

Read on November 12, 2026: E-file and payment methods by tax type, Use Sales Tax Web File, Software developers.

Signing in to Online Services

Online Services signs you in with a username and password from Log in | Create account, and resets a forgotten password by email. Each employee has their own username on the Business account, as a Business Master Administrator, Manager or User. With Fous you sign in once through the site's own sign-in with your own account, and the login is sealed with AES-256.

Worth knowing

History covers a few periods only

The Account Summary shows sales tax history for the last five filing periods and withholding for the last 13, at most three years back. Corporation tax shows the ten most recent periods since 2008.

Not every payment is in the history

Payment history shows payments with returns, extensions, estimated tax and PrompTax, but not payments under an installment payment agreement or on a bill issued by New York State.

Two accounts for an EIN ending in C

If your EIN ends with a C, you need one Business account with the C for Sales Tax Web File and another without it for corporation, withholding and highway use tax.

Maintenance windows and a 10-minute timeout

Online Services is down for maintenance Monday to Saturday 4:00 to 6:00 a.m. and Sunday 9:00 to 10:00 p.m. The notice response times out after ten minutes without activity and saves nothing.

More in Government: US state and local tax

• Ohio Business Gateway
• MyFTB
• CDTFA Online Services
• Colorado Revenue Online
• Florida DOR eServices File and Pay
• Georgia Tax Center
• INTIME
• LaTAP
• Maryland Tax Connect
• MassTaxConnect
• Michigan Treasury Online
• Minnesota e-Services
• My DOR
• myconneCT
• MyDORWAY
• myPATH
• MyTax Illinois
• MyTaxes Kentucky
• NCDOR eBusiness Center
• New Jersey Tax Portal
• OH|TAX eServices
• Texas Comptroller Webfile
• TNTAP
• Virginia Tax Business Online Services
• Wisconsin My Tax Account

Other industries: CalSavers, アスクル, Beeline, 340B ESP, AXA Connect, CCMS.