DevelopersLive

Billing API: read plan, wallet and usage from your own tools.

With the billing scope, read the workspace’s subscription, WhatsApp wallet balance, usage and available plans. The API is read-only.

See pricing
POST /api/whatsapp/messagesDemo
curl https://api.nexlerai.com/v1/messages \
  -H "Authorization: Bearer nx_live_••••" \
  -d '{
    "to": "+14155550123",
    "template": "order_update",
    "variables": ["Asha", "#1042"]
  }'

201 Created
{ "id": "msg_8f2c", "status": "queued" }

Sample data shown for illustration.

Overview

What Billing API does

Finance and ops teams often want wallet and plan data in their own dashboards. The Billing API exposes it read-only.

GET /api/billing returns the current subscription, per-channel wallet balances and usage counts. The full response also includes billing profile and payment-method summaries (card brand and last 4 only) — treat those as merchant PII and read only what you need.

GET /api/billing/plans lists available plans localized to the workspace’s billing country and currency.

Step by step

How it works

  1. 1

    Create a billing-scoped key

    In Settings → Developer API keys.

  2. 2

    Poll the snapshot

    GET /api/billing on a schedule.

  3. 3

    Alert on thresholds

    Notify your team when a wallet drops below your limit.

In the product

See it in action

app.nexlerai.com / inbox
Asha Verma ● online
AI replying
Hi! Is the blue one in stock? I need it by Friday.
Yes, 12 left in your size. Order today and it ships tomorrow.
Blue Runner
$49 · In stock
Type a reply…
Illustration with sample data

Sample data shown for illustration.

app.nexlerai.com / automations / cart-recovery
Trigger
Cart left for 1 hour
Wait
Then check the order is still unpaid
Send WhatsApp
“You left something behind” + 10% code
Live1,204 entered212 recovered · $6.1k
Illustration with sample data

Sample data shown for illustration.

Reference

Endpoints

GET/api/billing

Current subscription, wallet and usage snapshot.

GET/api/billing/plans

Available plans, localized to the workspace’s billing country and currency.

Billing snapshothttp
GET /api/billing
Authorization: Bearer nxk_live_your_key_here

{
  "success": true,
  "data": {
    "subscription": { "planId": "growth", "status": "active", "billingCycle": "monthly" },
    "wallets": {
      "whatsapp": { "balance": 1250, "currency": "INR" },
      "instagram": { "balance": 400, "currency": "INR" }
    },
    "usage": { "whatsapp": { "utility": 312, "marketing": 88 } }
  }
}

Before you start

Good to know

  • Billing changes (upgrades, top-ups) are made in the dashboard, not through the API.

About the author

Nexlerate Technologies Pvt LtdParent company, NexlerAI

Nexlerate Technologies Pvt Ltd is the parent company and engineering team behind NexlerAI. The company builds on the official WhatsApp Cloud API, Meta’s Instagram and Messenger platforms, and the Shopify app ecosystem, and writes these guides from how the product works today.

Start with the free Starter plan.

Connect your workspace first, then upgrade to Growth or Scale when you need more stores, seats and revenue workflows.