Skip to content

FousTNTAP

Turn TNTAP into an API

Get the Account Alerts and the tax due of each tax account on your TNTAP home screen as JSON, one API call each. A workflow can check every account each Monday morning and email you the alerts that were not there the Monday before.

Start building freeBook a demo

Works with your own TNTAP account. Fous is an independent product.

What you can build on TNTAP

  • Get account alerts

    Build this

    Reads the My Account section of the TNTAP home screen, then the Account Alerts of each tax account that shows a notification.

    Takes
    Account type (optional)
    Returns
    Account type, account ID, alert, filing period

  • Get tax due

    Build this

    Reads the tax due shown on the TNTAP home screen for each tax account after a return has been submitted.

    Takes
    Account type (optional)
    Returns
    Account type, account ID, filing period, tax due

  • File a no-sales sales and use tax return

    Build this

    Opens the return from Account Alerts, answers No to a software vendor file, picks the location, answers that there are no sales to report and submits.

    Takes
    Account ID, location, filing period
    Returns
    Account ID, location, filing period, confirmation

Automate TNTAP 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 account alerts across your tax accounts

    Build this
    Starts
    Every Monday at 8:00
    Step 1
    Get the Account Alerts of every tax account on your TNTAP home screen.
    Step 2
    Keep the alerts that were not there on the last run.
    Step 3
    Email you the list, one section per account type.

  • Tax due, handed to accounting

    Build this
    Starts
    On the 1st of every month at 9:00
    Step 1
    Get the tax due shown for each tax account on the TNTAP home screen.
    Step 2
    Stop when no account shows tax due.
    Step 3
    Post account type, account ID, filing period and tax due 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 account alerts” 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": "tntap.tn.gov/get_account_alerts",
    "input": {
      "account_type": "Sales and Use Tax"
    }
  }'
Example response
{
  "status": "completed",
  "data": {
    "accounts": [
      {
        "account_type": "Sales and Use Tax",
        "account_id": "1000123456",
        "alerts": [
          {
            "alert": "Return due",
            "filing_period": "2026-10"
          }
        ]
      },
      {
        "account_type": "Sales and Use Tax",
        "account_id": "1000654321",
        "alerts": []
      }
    ],
    "count": 2
  }
}

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.

TNTAP’s own options

The Department of Revenue's e-filing pages describe two routes: filing in TNTAP yourself, or filing through approved software. Its software vendor page covers sales and use tax, franchise and excise tax and Hall income tax, and links approved vendor lists. It describes no API for TNTAP account holders.

OptionWhat it coversWhat it takes
Approved software vendorsReturns prepared in approved software. In TNTAP, a sales and use tax return asks whether you are submitting a file from your software vendor.Software from a vendor on the department's approved list for that tax.
MeF Portal vendor listThe list of approved software vendors that TNTAP publishes in its MeF Portal.Software from a listed vendor. Vendors apply to the department to become approved.
TNTAP by handReturns, payments, registration and exemptions, with Account Alerts and tax due for each tax account on the home screen.A TNTAP logon, with each tax account added through Gain Access to a Tax Account and its Letter ID.

Read on November 12, 2026: Filing with a Software Vendor, Sales and Use Tax, TNTAP.

Signing in to TNTAP

TNTAP signs you in with a username and password, then asks for a confirmation code sent by email or text, whichever you chose when you created your logon. With Fous you sign in once through TNTAP's own sign-in with your own logon, and the login is sealed with AES-256. When your logon gets its code by email, that step is handled and an expired session is signed back in.

Worth knowing

Each tax account is added with a Letter ID
Gain Access to a Tax Account, under I Want To and Manage Accounts, adds an account to your logon. It asks for the account type, the Account ID, the zip code and a Letter ID.
A return starts from the account's alert
You open a sales and use tax return from the notification under My Account and then Account Alerts. TNTAP asks whether you are submitting a software vendor file, then which location you are filing for.
Business tax below the $100,000 threshold
If you report gross sales in a jurisdiction below the $100,000 filing threshold, TNTAP calculates the tax on them even when it is under $22. A saved draft may prepopulate $22 in tax due.
Payment comes after the return
Once a return is submitted, its tax due shows on the home screen. Selecting the amount leads to the payment method, and TNTAP confirms the return and the payment separately.

More in Government: US state and local tax

Other industries: EAMS (Washington ESD), Lyreco Webshop, Workday VNDLY, AAH Hub, HealthSherpa, TyMetrix 360.

Frequently asked questions

Not one that the Department of Revenue describes for account holders. Its e-filing pages offer two routes: filing in TNTAP yourself, or through approved software, with approved vendor lists linked from its software vendor page.

Use Gain Access to a Tax Account under I Want To and Manage Accounts on the home screen. Choose the account type, enter the Account ID and the zip code, verify with the Letter ID and submit the request.

Open the return from the account's Account Alerts, answer that you are not submitting a software vendor file, choose the location, answer that you have no sales to report for the period and submit. You can build a method that does this for an account ID, location and filing period you give it.

A saved draft may prepopulate $22 in tax due when you report gross sales below the $100,000 filing threshold in a jurisdiction. You can file and pay that amount, or click the return's introductory questions again and TNTAP recalculates the tax from the gross sales you reported.

No. Fous is an independent product. You use it with your own TNTAP logon, and a method reads and does only what that logon can.

Put TNTAP 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.

Start building freeBook a demo

Read nextVirginia Tax Business Online ServicesWisconsin My Tax AccountOhio Business GatewayEAMS (Washington ESD)How methods workHow workflows run

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of TNTAP (Tennessee Department of Revenue). 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.