# Get your New Jersey Tax Portal accounts through an API

> Read the balances, filing and payment history and service requests of each Taxpayer Entity in the New Jersey Tax Portal with an API call. A workflow can check every entity you manage each morning and email you the tax accounts with a balance due.

Page: https://fous.com/automate/new-jersey-tax-portal
Updated: 2026-11-12

Works with your own New Jersey Tax Portal account. Fous is an independent product.

## What you can build on the NJ Tax Portal

### Get tax account balances

Reads the balance of each tax account linked to one Taxpayer Entity, such as Sales and Use Tax or Partnership, with the filing period it belongs to.

- Takes: Taxpayer Entity or Taxpayer ID, tax type (optional)
- Returns: Tax account, tax type, filing period, balance due, total balance

### Get filing and payment history

Reads the returns filed and payments made on one tax account, from the history the portal keeps for online transactions.

- Takes: Taxpayer Entity, tax type, from date (optional)
- Returns: Filing period, return type, filed date, confirmation number, payment date, payment amount, payment method, status

### Check service requests

Reads Manage Service Requests for one Taxpayer Entity: each request you sent the Division, its Case Status and the Division's response.

- Takes: Taxpayer Entity, case status (optional)
- Returns: Request number, request type, submitted date, case status, response

### Pay a tax account balance

Makes a payment on one tax account and filing period by ACH Direct Debit from a saved bank account, and returns the confirmation.

- Takes: Taxpayer Entity, tax type, filing period, amount, saved bank account, payment date
- Returns: Confirmation number, tax type, filing period, amount, payment date, status

## Automate the NJ Tax Portal 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.

### Balances due, every Taxpayer Entity you manage

Starts: Every weekday at 7:00

1. For each Taxpayer Entity you name, get the tax account balances.
2. Keep the tax accounts with a balance due above zero.
3. Email you the list, one section per entity, with tax type, filing period and amount.

### Service requests with a new Case Status

Starts: Every Monday at 8:00

1. For each Taxpayer Entity, check Manage Service Requests.
2. Keep the requests whose Case Status or response changed since the last run.
3. Post each one, with request number, type, Case Status and response, to your webhook.

### Payments posted, handed over to accounting

Starts: Every day at 18:00

1. For each Taxpayer Entity, get the filing and payment history for Sales and Use Tax.
2. Keep the payments that were not there on the last run, and stop when there are none.
3. Post each payment's filing period, date, amount and confirmation number to your accounting 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 tax account balances” 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": "taxportal.nj.gov/get_tax_account_balances",
    "input": {
      "taxpayer_entity": "Acme Supply LLC"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "taxpayer_entity": "Acme Supply LLC",
    "accounts": [
      {
        "tax_account": "Acme Supply LLC",
        "tax_type": "Sales and Use Tax",
        "filing_period": "2026-07-01 to 2026-09-30",
        "balance_due": 412.37
      }
    ],
    "total_balance": 412.37,
    "currency": "USD"
  }
}
```

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.

## The NJ Tax Portal’s own options

The Division's portal guides and FAQ describe no API for the NJ Tax Portal. Businesses file and pay on screen, with a profile or through Quick Access, and view their history with a profile. CBT returns cannot be filed in the portal, and partnership returns with more than 200 partners go through third-party tax software.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Quick Access | Files a return or makes a payment without a portal profile. | No profile needed. It keeps no payment history, and a guest payment cannot be cancelled. |
| Third-party tax software | Partnership returns with more than 200 partners, which are too large to file in the portal. | Tax software from a third party. Data cannot be imported from it into the portal. |
| The NJ Tax Portal by hand | Returns, payments, balances, filing and payment history, correspondence and service requests, one Taxpayer Entity at a time. | A free Administrator or Delegate profile, signed in with a myNewJersey ID. |

Read on November 12, 2026: [NJ Tax Portal FAQs and portal help](https://www.nj.gov/treasury/taxation/taxportal/faqs.shtml), [Creating a New Jersey Tax Portal Account: Administrator](https://www.nj.gov/treasury/taxation/pdf/portal-guides/portal-createadmin.pdf), [New Jersey Tax Portal](https://www.nj.gov/treasury/taxation/taxportal/index.shtml).

## Signing in to the NJ Tax Portal

The NJ Tax Portal signs you in with your myNewJersey ID and password. Multi-factor authentication, which adds a one-time code from a device, is optional. With Fous you sign in once through the portal's own sign-in with your own account: the login is sealed with AES-256, and when the account uses a password alone, an expired session is signed back in.

## Worth knowing

- **Older periods stay in the old system**: Phase 1 taxes, Sales and Use Tax among them, moved on May 14, 2025, and Phase 2a on November 9, 2026. The original filing system is now for information only, so older returns are read there.
- **Delegates see only what they were granted**: An Administrator gives each Delegate chosen Functions and Authorizations, with start and end dates. A preparer creates a Delegate profile and sees each client entity in the Delegate Portal.
- **36 months of online history**: Online transactions are viewable in the portal for up to 36 months. Quick Access users have no payment history, so a profile is needed to read it.
- **Not every return is filed in the portal**: CBT returns cannot be filed there, and partnership returns are limited to 200 partners. Data cannot be imported from tax software.

## 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)
- [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)
- [TNTAP](https://fous.com/automate/tntap.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: [DIR Public Works eCPR](/automate/dir-public-works-ecpr), [Staples Business Advantage](/automate/staples-business-advantage), [Bullhorn](/automate/bullhorn), [CAQH Provider Data Portal](/automate/caqh-provider-data-portal), [Aviva Broker](/automate/aviva-broker), [Arbitration Forums](/automate/arbitration-forums).

## Frequently asked questions

### Does the New Jersey Tax Portal have an API?

Not one the Division documents. Its portal guides and FAQ describe filing and paying on screen, with a profile or through Quick Access, and viewing history with a profile. Partnership returns with more than 200 partners go through third-party tax software, and data cannot be imported into the portal from it.

### Can my tax preparer use the portal for my business?

Yes, as a Delegate. The preparer creates a Delegate profile and gives you their email address and Registration Confirmation Number. You add them under Profile Information, Manage Delegates, and choose their Functions and Authorizations, start and end dates.

### Where are returns I filed before the NJ Tax Portal?

In the original filing system, which stays available for information only. You log in there with your ID and PIN and select View Return. Your gross receipts are on line 1, which you need when you create a portal profile.

### How far back can I see payments in the portal?

Up to 36 months of online transactions. Profile holders also see balances, filing history and correspondence, and can edit or cancel a payment before its settlement date.

### Is Fous affiliated with the New Jersey Division of Taxation?

No. Fous is an independent product. You use it with your own NJ Tax Portal profile, and a method reads and does only what that profile can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of New Jersey Tax Portal (New Jersey Division 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.
