Getting Started

The Brenoz Reseller API lets your application browse the live Brenoz catalogue, place orders against your own Brenoz wallet balance, and get notified when an order's status changes — all under your own Brenoz account.

Status: the Reseller API is enabled for an internal pilot, not yet general availability. This site documents the finalized v1 contract so approved integrators can build against it today, ahead of a wider rollout.

Base URL

Every path on this site is relative to:

https://api.brenoz.com

For example, GET /api/v1/reseller/catalog/products means GET https://api.brenoz.com/api/v1/reseller/catalog/products.

1. Create an API key

Sign in to your Brenoz account and open Account → Developer (https://brenoz.com/account/developer). From there you can:

Create a new API key, choosing exactly the scopes it needs.
Copy the secret shown — it is displayed exactly once and cannot be retrieved again. If you lose it, revoke the key and create a new one.
Register a webhook endpoint if you'd rather be notified than poll.

2. Make your first request

Every request is authenticated with a standard bearer header:

GET https://api.brenoz.com/api/v1/reseller/catalog/products
Authorization: Bearer brz_live_...

See the Authentication page for the full scope/error model.

3. Check your wallet balance

Orders debit your existing Brenoz wallet — there is no separate reseller billing relationship, so it's worth checking your balance before placing an order:

GET https://api.brenoz.com/api/v1/reseller/wallet
Authorization: Bearer brz_live_...

{ "balance": "42.50", "currency": "USD" }

4. Place an order

POST https://api.brenoz.com/api/v1/reseller/orders
Authorization: Bearer brz_live_...
Idempotency-Key: a-unique-string-you-generate
Content-Type: application/json

{
  "package_id": "...",
  "quantity": 1
}

The order is created immediately and debits your account's existing Brenoz wallet balance — see Orders for the full idempotency and status model.

5. Find out what happened

Either poll GET /api/v1/reseller/orders/{order_id}, or register a webhook and let Brenoz tell you — see Order Status & Delivery and Webhooks.

Full API reference

Every endpoint, request/response shape, and required scope is listed on the API Reference page, generated directly from the published OpenAPI contract.