Reseller API

Reseller API method reference

Every reseller API endpoint in one table with its scope and idempotency flag, plus a link to the OpenAPI 3.1 specification of OneProvider, ready to import.

Every reseller API endpoint in one table with its scope and idempotency flag, plus a link to the OpenAPI 3.1 specification.

All models, capabilities, and prices Documentation index for AI agents: https://oneprovider.dev/docs/llms.txt

Base URL: https://app.oneprovider.dev/partner/v1. Machine-readable OpenAPI 3.1 specification: https://app.oneprovider.dev/partner/v1/openapi.yaml (public, no token needed).

The “Idempotency” column marks the methods that require the Idempotency-Key header. Scope “any” means any valid token, “none” means no token is needed.

API methods

Method	Path	Scope	Idempotency	Purpose
`GET`	`/me`	`any`	-	Token, scopes, reseller.
`GET`	`/balance`	`read`	-	Reseller balance, reserved, free, wholesale price, top-up providers.
`GET`	`/balance/transactions`	`read`	-	Balance transactions (cursor).
`POST`	`/balance/topups`	`billing`	required	Create a top-up payment, returns pay_url.
`GET`	`/balance/topups/{order_id}`	`billing`	-	Status of your own payment.
`GET`	`/pricing`	`read`	-	Wholesale price, discount, limits.
`GET`	`/models`	`read`	-	Model catalog and live status.
`GET`	`/customers`	`read`	-	List customers (?external_id=).
`GET`	`/customers/{id}`	`read`	-	A customer.
`POST`	`/customers`	`keys`	-	Create a customer.
`PATCH`	`/customers/{id}`	`keys`	-	Edit name, note, block (blocked).
`GET`	`/keys`	`read`	-	List keys (?status=, ?query=, ?customer_id=).
`GET`	`/keys/{id}`	`read`	-	A key without the secret, with dashboard_url.
`GET`	`/keys/{id}/usage`	`read`	-	Daily usage (empty for now, coming soon).
`POST`	`/keys`	`keys`	required	Issue a key; the secret is returned once.
`POST`	`/keys/bulk`	`keys`	required	Issue several identical keys at once.
`PATCH`	`/keys/{id}`	`keys`	-	Limit, expiry (expires_days/hours) or extension (extend_days/hours), name, customer label.
`DELETE`	`/keys/{id}`	`keys`	-	Delete a key (200 or 202).
`POST`	`/keys/{id}/topup`	`keys`	required	Add an amount to the key limit.
`POST`	`/keys/{id}/rotate`	`keys`	required	Rotate a key: new secret, the old one stops working.
`POST`	`/keys/{id}/pause`	`keys`	-	Pause a key.
`POST`	`/keys/{id}/resume`	`keys`	-	Resume a key.
`POST`	`/orders`	`keys`	required	A paid customer order: new key or top-up.
`GET`	`/orders`	`read`	-	List orders (?external_order_id=).
`GET`	`/orders/{id}`	`read`	-	An order.
`GET`	`/plans`	`read`	-	Your plans.
`POST`	`/plans`	`plans`	-	Create a plan.
`PATCH`	`/plans/{id}`	`plans`	-	Edit a plan.
`DELETE`	`/plans/{id}`	`plans`	-	Delete a plan.
`GET`	`/code-batches`	`codes`	-	List code batches.
`POST`	`/code-batches`	`codes`	required	Create a code batch.
`GET`	`/code-batches/{id}`	`codes`	-	A batch.
`GET`	`/code-batches/{id}/codes`	`codes`	-	Codes of a batch (?status=).
`POST`	`/code-batches/{id}/revoke`	`codes`	-	Revoke the unredeemed codes.
`GET`	`/codes/{code}`	`codes`	-	Status of a code.
`POST`	`/codes/{code}/redeem`	`codes`	required	Redeem a code into a key.
`GET`	`/stats`	`read`	-	Daily stats (?days=1..90).
`GET`	`/audit`	`read`	-	Action log (filters period, actor, action, q).
`GET`	`/bot`	`bot`	-	The shop bot and the support bot (no tokens).
`GET`	`/payment-providers`	`bot`	-	Cashiers of the bot: CryptoBot, xRocket (no tokens).
`GET`	`/webhooks`	`webhooks`	-	List webhooks.
`POST`	`/webhooks`	`webhooks`	-	Create a webhook; the secret is shown once.
`DELETE`	`/webhooks/{id}`	`webhooks`	-	Delete a webhook.
`POST`	`/webhooks/{id}/test`	`webhooks`	-	Send a test event.
`GET`	`/webhooks/{id}/deliveries`	`webhooks`	-	Delivery log.
`GET`	`/openapi.yaml`	`none`	-	OpenAPI 3.1 specification (public).

Shared rules (pagination, errors, limits) are described on Authorization & limits .

Last updated: 2026-10-21 Found a bug? @Oneproviderhelpbot