# Get your Rev360 tax records through an API

> Read your Tax Wallet balances, filing and payment statuses, refund requests and Tax Clearance Certificates from Rev360 with one API call each. Or have a workflow check last month's VAT and WHT filings before the 21st and email you what is still open.

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

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

## What you can build on Rev360

### Get Tax Wallet balances

Reads the balances shown in Tax Wallet on the Self-Service Portal, for each tax type or the one you give.

- Takes: Tax type (optional)
- Returns: Tax type, balance, currency, as-of date

### Check filing and payment status

Reads your returns under Self Tax Filing and your payments under Payments, with the status Rev360 shows for each.

- Takes: Tax type (optional), period
- Returns: Tax type, period, filing status, filed date, amount due, payment status, payment date

### Track refund requests

Reads your requests under Refunds with the status Rev360 shows for each one.

- Takes: Status (optional)
- Returns: Request reference, tax type, amount, date requested, status

### Get a Tax Clearance Certificate

Opens Tax Clearance and reads the TCCs listed there, with the PDF of the latest certificate.

- Takes: Year (optional)
- Returns: TCC number, year, issue date, status, PDF of the latest certificate

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

### Open VAT and WHT filings before the 21st

Starts: Every month on the 15th at 9:00, Africa/Lagos time

1. Check filing and payment status for VAT and Withholding Tax for last month.
2. Keep the returns not filed and the payments not made.
3. Email you the list with tax type, period, status and amount due.

### Refund requests and Tax Wallet, weekly to finance

Starts: Every Monday at 8:00, Africa/Lagos time

1. Track refund requests and keep the ones whose status changed since the last run.
2. Get Tax Wallet balances for every tax type.
3. Post the changed refunds and the balances to your finance 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 Tax Wallet 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": "selfservice.nrs.gov.ng/get_tax_wallet_balances",
    "input": {
      "tax_type": null
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "taxpayer": "Acme Nigeria Limited",
    "balances": [
      {
        "tax_type": "Value Added Tax",
        "balance": 1845000,
        "currency": "NGN",
        "as_of": "2026-11-12"
      }
    ]
  }
}
```

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.

## Rev360’s own options

The NRS describes Rev360's Self-Service Portal as the place to register, file and pay taxes, download Tax Clearance Certificates and receipts, and track filings and payments. Its pages describe no API for those services. Invoices go through a separate platform, the National E-Invoice system (Merchant Buyer Solution).

| Option | What it covers | What it takes |
| --- | --- | --- |
| National E-Invoice system (Merchant Buyer Solution) | Creating, validating, submitting and tracking electronic invoices, linked to your business Tax ID. Not returns, payments or TCCs. | A business Tax ID and access to the E-Invoicing Portal at einvoice.nrs.gov.ng. |
| Rev360 Self-Service Portal, by hand | My Profile, Self Tax Filing, Payments, Tax Clearance, Tax Wallet, Refunds and Assessments, one screen at a time. | An NRS SSO account, opened from selfservice.nrs.gov.ng. |

Read on November 12, 2026: [NRS: Self-Service Portal](https://www.nrs.gov.ng/taxpayer-services/self-service-portal), [NRS: E-Invoicing Portal](https://www.nrs.gov.ng/taxpayer-services/e-invoice), [Rev360 Taxpayer Self-Service Portal](https://selfservice.nrs.gov.ng/).

## Signing in to Rev360

Rev360 signs you in through NRS SSO: Continue with NRS SSO on selfservice.nrs.gov.ng redirects you to the NRS Single Sign-On portal. Taxpayers can give tax consultants their own role-based access instead of sharing the main login. With Fous, you sign in once through that page with your own account, and the login is sealed with AES-256, never returned by the API or written to logs.

## Worth knowing

- **The 21st is the monthly deadline**: VAT returns and payment are due by the 21st of the month after the transaction month, and withheld tax by the 21st of the month after deduction. Company Income Tax is due within 6 months of the year end.
- **Check what was migrated from TaxPro Max**: Profiles, compliance history and balances moved from TaxPro Max automatically. Advisers recommend checking migrated withholding tax credits and VAT credit balances before relying on them.
- **Returns are built from Excel schedules**: Rev360 offers downloadable Excel schedules for preparing returns, completed offline and uploaded as part of filing. Filing a return means preparing and uploading those schedules, not only filling in a form.

## More in Government: Middle East and Africa

- [CAC Company Registration Portal](https://fous.com/automate/cac-company-registration-portal.md)
- [CIPC eServices](https://fous.com/automate/cipc-eservices.md)
- [GDRFA Dubai Smart Services](https://fous.com/automate/gdrfa-dubai-smart-services.md)
- [eTIMS](https://fous.com/automate/etims.md)
- [Qiwa](https://fous.com/automate/qiwa.md)
- [ICP Smart Services](https://fous.com/automate/icp-smart-services.md)
- [KRA iTax](https://fous.com/automate/kra-itax.md)
- [SARS eFiling](https://fous.com/automate/sars-efiling.md)
- [SIMPL](https://fous.com/automate/simpl.md)
- [Egyptian Tax Authority e-Services](https://fous.com/automate/egyptian-tax-authority-e-services.md)
- [ZATCA e-Services](https://fous.com/automate/zatca-e-services.md)
- [uFiling](https://fous.com/automate/ufiling.md)
- [EmaraTax](https://fous.com/automate/emaratax.md)
- [Mudad](https://fous.com/automate/mudad.md)

Other industries: [Cégkapu](/automate/cegkapu), [FCA RegData](/automate/fca-regdata), [DOB NOW](/automate/dob-now), [Loan Product Advisor](/automate/loan-product-advisor), [Invoice Processing Platform](/automate/invoice-processing-platform), [OpenGov Procurement](/automate/opengov-procurement).

## Frequently asked questions

### Does Rev360 have an API?

Not for filing, payments or tax clearance, as far as the NRS's pages show. They describe the Self-Service Portal as a website for filing, paying and tracking, with no API. Electronic invoices go through a separate NRS platform, the National E-Invoice system (Merchant Buyer Solution).

### Do TaxPro Max users need to register again on Rev360?

No. Existing taxpayers' profiles, compliance history and balances were migrated, and login details are sent to the registered email address, with a temporary password to reset on first sign-in. New taxpayers register at selfservice.nrs.gov.ng.

### When are VAT and withholding tax returns due on Rev360?

By the 21st day of the following month. VAT returns and payment are due by the 21st after the transaction month, and withholding tax remittance by the 21st after the month of deduction.

### Can our tax consultant work in Rev360 for us?

Yes. Rev360 lets a taxpayer grant role-based access to tax consultants and other representatives, so they work in the account without the company's own login.

### Is Fous affiliated with the Nigeria Revenue Service?

No. Fous is an independent product. You sign in to Rev360 with your own account, and a method reads and does only what that account can.

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