# 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.

Page: https://fous.com/automate/tntap
Updated: 2026-11-12

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

## What you can build on TNTAP

### Get account alerts

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

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

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](/product/workflows) 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

Starts: Every Monday at 8:00

1. Get the Account Alerts of every tax account on your TNTAP home screen.
2. Keep the alerts that were not there on the last run.
3. Email you the list, one section per account type.

### Tax due, handed to accounting

Starts: On the 1st of every month at 9:00

1. Get the tax due shown for each tax account on the TNTAP home screen.
2. Stop when no account shows tax due.
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](/product/methods), 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.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Approved software vendors | Returns 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 list | The 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 hand | Returns, 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](https://www.tn.gov/revenue/e-filing-information/electronic-filing-using-a-software-vendor.html), [Sales and Use Tax](https://www.tn.gov/revenue/taxes/sales-and-use-tax.html), [TNTAP](https://tntap.tn.gov/eservices/_/).

## 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

- [Ohio Business Gateway](https://fous.com/automate/ohio-business-gateway.md)
- [MyFTB](https://fous.com/automate/myftb.md)
- [CDTFA Online Services](https://fous.com/automate/cdtfa-online-services.md)
- [Colorado Revenue Online](https://fous.com/automate/colorado-revenue-online.md)
- [Florida DOR eServices File and Pay](https://fous.com/automate/florida-dor-eservices-file-and-pay.md)
- [Georgia Tax Center](https://fous.com/automate/georgia-tax-center.md)
- [INTIME](https://fous.com/automate/intime.md)
- [LaTAP](https://fous.com/automate/latap.md)
- [Maryland Tax Connect](https://fous.com/automate/maryland-tax-connect.md)
- [MassTaxConnect](https://fous.com/automate/masstaxconnect.md)
- [Michigan Treasury Online](https://fous.com/automate/michigan-treasury-online.md)
- [Minnesota e-Services](https://fous.com/automate/minnesota-e-services.md)
- [My DOR](https://fous.com/automate/my-dor.md)
- [myconneCT](https://fous.com/automate/myconnect.md)
- [MyDORWAY](https://fous.com/automate/mydorway.md)
- [myPATH](https://fous.com/automate/mypath.md)
- [MyTax Illinois](https://fous.com/automate/mytax-illinois.md)
- [MyTaxes Kentucky](https://fous.com/automate/mytaxes-kentucky.md)
- [NCDOR eBusiness Center](https://fous.com/automate/ncdor-ebusiness-center.md)
- [New Jersey Tax Portal](https://fous.com/automate/new-jersey-tax-portal.md)
- [NY Business Online Services](https://fous.com/automate/ny-business-online-services.md)
- [OH|TAX eServices](https://fous.com/automate/oh-tax-eservices.md)
- [Texas Comptroller Webfile](https://fous.com/automate/texas-comptroller-webfile.md)
- [Virginia Tax Business Online Services](https://fous.com/automate/virginia-tax-business-online-services.md)
- [Wisconsin My Tax Account](https://fous.com/automate/wisconsin-my-tax-account.md)

Other industries: [EAMS (Washington ESD)](/automate/eams-washington-esd), [Lyreco Webshop](/automate/lyreco-webshop), [Workday VNDLY](/automate/workday-vndly), [AAH Hub](/automate/aah-hub), [HealthSherpa](/automate/healthsherpa), [TyMetrix 360](/automate/tymetrix-360).

## Frequently asked questions

### Does TNTAP have an API?

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.

### How do I add another sales tax account to my TNTAP logon?

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.

### How do I file a TNTAP sales and use tax return with no sales?

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.

### Why does TNTAP show $22 of business tax due on my draft?

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.

### Is Fous affiliated with the Tennessee Department of Revenue?

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.

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.