TaxStreem Logo

Single VAT filing

Use the single filing endpoint when you need to submit an individual VAT transaction — for example, at point of sale or on invoice issuance — and need an immediate response for your workflow.

Endpoint

POST https://api.taxstreem.com/v1/flux/vat/single-filing

Request fields

FieldTypeDescription
encryptedPayload*stringRev360 credentials encrypted with your shared secret.
filingId*stringYour unique identifier for this filing.
month*integerFiling month (1–12).
year*integerFiling year (e.g. 2025).
vatStatus*integer0 = VATtable, 1 = Zero-rated, 2 = Exempt.
amount*floatTransaction amount in NGN.
item*stringDescription of the goods or services.
narrationstringAdditional context — e.g. invoice narration.
taxId*stringBusiness TaxID.
beneficiarystringCounterparty name — customer or vendor.

Example request

curl -X POST https://api.taxstreem.com/v1/flux/vat/single-filing \
  -H "x-api-key: txsm_test_SK489c..." \
  -H "Content-Type: application/json" \
  -d '{
    "encryptedPayload": "enc_...",
    "filingId": "fil_vat_001",
    "month": 3,
    "year": 2025,
    "data": [
      {
        "vatStatus": 0,
        "amount": 107500,
        "item": "Professional consultancy",
        "narration": "Invoice INV-2025-001",
        "taxId": "1234567890",
        "beneficiary": "Acme Nigeria Ltd"
      }
    ]
  }'

Response

{
  "status": "accepted",
  "message": "VAT filing accepted",
  "data": {
    "id": "xaee2ddf-effvkfes",
    "filingId": "fil_vat_001",
    "created_at": "2025-03-20T10:00:00Z"
  }
}
Filing is asynchronous. Listen to the vat.filing.success or vat.filing.failed webhook for the final confirmation from NRS.