⚡ API keys⚡ Sandbox⚡ Code samples

Tax APIs Built for Developers

One API, one auth model, one set of docs. Get sandbox credentials, post a test invoice, read the logs and go to production — all from one platform.

Read the Docs Start Sandbox

Runnable samples in cURL, JavaScript, PHP, Python, C# and Java.

POST /api/v1/invoices

curl -X POST https://taxbridge.themetasum.com/api/v1/invoices \
  -H "Authorization: Bearer tbk_test_9f3a21c7b4d6e8f0_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 0b6d1c4e-7f9a-4a51-8d3c-2e5f7a91b204" \
  -H "X-Tax-Authority: PRA" \
  -d '{
    "invoiceNumber": "INV-10001",
    "invoiceDate": "2026-08-10T10:30:00",
    "invoiceType": "Sale",
    "currency": "PKR",
    "paymentMode": "Cash",
    "customer": { "name": "Walk-in Customer" },
    "items": [{
      "description": "Chicken Karahi Full", "hsCode": "11001010",
      "quantity": 1, "unitPrice": 1500.00,
      "taxRate": 16, "taxAmount": 240.00, "total": 1740.00
    }],
    "subTotal": 1500.00, "tax": 240.00, "total": 1740.00
  }'

From account to go-live in 10 steps

1. Create a TaxBridge account

2. Create an application / project

Group your keys and settings under one app.

3. Select a tax authority

Choose FBR, PRA, SRB or KPRA — or several.

4. Generate sandbox credentials

Store authority credentials, or switch on the simulator to build with no network call.

5. Read the documentation

Auth, the canonical payload, the response envelope and error codes — all in one place.

6. Send a test request

POST your first invoice to /api/v1/invoices with a test key.

7. Review the response

Inspect status, authorityInvoiceNumber, qrCode and quota.

8. Check logs & fix

Every request/response is logged; normalized errors point at the exact field.

9. Complete production requirements

Provide real credentials and complete company/branch configuration.

10. Generate production keys & go live

Issue a live key and switch your endpoint. Production and sandbox stay fully separate.

Authentication

Every request carries a scoped bearer key. Keys are environment-specific and optionally pinned to one authority.

tbk_test_... for sandbox, tbk_live_... for production
Shown once; stored as a SHA-256 hash plus the last 4 characters
Send Idempotency-Key on every POST to make retries safe

POST /api/v1/invoices

curl -X POST https://taxbridge.themetasum.com/api/v1/invoices \
  -H "Authorization: Bearer tbk_test_9f3a21c7b4d6e8f0_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 0b6d1c4e-7f9a-4a51-8d3c-2e5f7a91b204" \
  -H "X-Tax-Authority: PRA" \
  -d '{
    "invoiceNumber": "INV-10001",
    "invoiceDate": "2026-08-10T10:30:00",
    "invoiceType": "Sale",
    "currency": "PKR",
    "paymentMode": "Cash",
    "customer": { "name": "Walk-in Customer" },
    "items": [{
      "description": "Chicken Karahi Full", "hsCode": "11001010",
      "quantity": 1, "unitPrice": 1500.00,
      "taxRate": 16, "taxAmount": 240.00, "total": 1740.00
    }],
    "subTotal": 1500.00, "tax": 240.00, "total": 1740.00
  }'

📜

In-context docs

Documentation with runnable cURL, JavaScript, PHP, Python, C# and Java samples.

🧪

Sandbox playground

Try requests against the simulator before touching production.

📡

Webhooks

Signed webhook payloads for async status (Business and above).

📊

Usage & logs

Live usage dashboards, quota, and full request/response logs.

⚡

Rate limits

Clear per-plan request rates with Retry-After on 429.

🔧

Error normalization

One error vocabulary across all four authorities.

Start building with TaxBridge

Create a sandbox key and post your first test invoice in minutes.

Start Sandbox API Documentation

No developers? No API? No problem

Don’t want to build an integration at all?

Just register your business with Sum Cloud POS — it already files fiscal invoices to FBR, PRA, SRB and KPRA for you. No API, no development, nothing to connect or maintain. Start selling with compliant invoices out of the box.