Get your Rev360 tax records through an API

What you can build on Rev360

• Get Tax Wallet balances

  Build this

  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

  Build this

  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

  Build this

  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

  Build this

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

  Build this

  Starts

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

  Step 1

  Check filing and payment status for VAT and Withholding Tax for last month.

  Step 2

  Keep the returns not filed and the payments not made.

  Step 3

  Email you the list with tax type, period, status and amount due.

• Refund requests and Tax Wallet, weekly to finance

  Build this

  Starts

  Every Monday at 8:00, Africa/Lagos time

  Step 1

  Track refund requests and keep the ones whose status changed since the last run.

  Step 2

  Get Tax Wallet balances for every tax type.

  Step 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, 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.

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
    }
  }'

{
  "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).

Read on November 12, 2026: NRS: Self-Service Portal, NRS: E-Invoicing Portal, Rev360 Taxpayer Self-Service Portal.

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
• CIPC eServices
• GDRFA Dubai Smart Services
• eTIMS
• Qiwa
• ICP Smart Services
• KRA iTax
• SARS eFiling
• SIMPL
• Egyptian Tax Authority e-Services
• ZATCA e-Services
• uFiling
• EmaraTax
• Mudad

Other industries: Cégkapu, FCA RegData, DOB NOW, Loan Product Advisor, Invoice Processing Platform, OpenGov Procurement.