API ReferenceBilling

Cette page n'est disponible qu'en anglais.

Retrieve billing

GET /rest/v1/billing

GET
/billing

Current plan, status, renewal date, payment method, usage, recent invoices and, for every plan and interval, whether the store can switch to it right now and, if not, why (e.g. "The store has 3 accounts on one channel; Pro allows 2 per channel."). Stores billed through Shopify, Wix or WooCommerce.com can read here but manage billing on that platform (managed_elsewhere). Requires billing:read.

AuthorizationBearer <token>

Authorization: Bearer nbl_live_... (or nbl_test_... for test mode). Test-mode writes are validated and simulated but never persisted and never touch channels; simulated results are marked simulated.

In: header

Response Body

application/json

application/json

curl -X GET "https://example.com/billing"
{  "object": "billing",  "billing_source": "stripe",  "managed_elsewhere": null,  "plan": {    "key": "pro",    "name": "Pro",    "interval": "month"  },  "status": "trialing",  "trial": true,  "current_period_end": "2019-08-24T14:15:22Z",  "cancel_at_period_end": true,  "payment_method": {    "brand": "visa",    "last4": "4242"  },  "usage": {    "products": 0,    "max_accounts_on_one_channel": 0,    "team_members": 0  },  "plans": [    {      "key": "basic",      "name": "Enterprise",      "limits": {        "products": 5000,        "accounts_per_channel": 4,        "team_members": 1,        "running_promotions": 1      },      "prices": {        "month": {          "amount": 79,          "currency": "usd",          "selectable": true,          "reason": "string"        },        "year": {          "amount": 79,          "currency": "usd",          "selectable": true,          "reason": "string"        }      }    }  ],  "invoices": [    {      "amount": "49.00",      "status": "paid",      "url": "http://example.com",      "created_at": "2019-08-24T14:15:22Z"    }  ],  "actions": {    "change_plan": true,    "update_payment_method": true,    "cancel": true,    "manage": true  }}

Dernière mise à jour le 15 octobre 2026

Besoin d'aide ?

Écrivez-nous et une personne vous répond, généralement sous un jour ouvré.