Reseller API
Connect your site or bot
List products, check your balance, buy, and poll orders with an API key from your account.
Authentication
Send the key in the X-Api-Key header. Create a key on the API tab of your account. The full key is shown only once.
List products
GET /api/v1/products
Returns countries you can sell, with the current price and stock. Filter with tier=old or tier=new, and country as an ISO code or country id.
curl
curl "https://acceptororg.com/api/v1/products?tier=old&country=IT" \ -H "X-Api-Key: acc_your_key"
JavaScript
const res = await fetch("https://acceptororg.com/api/v1/products?tier=new", {
headers: { "X-Api-Key": "acc_your_key" },
});
const data = await res.json();Balance
GET /api/v1/balance
Returns the USD balance of the key owner.
curl
curl https://acceptororg.com/api/v1/balance \ -H "X-Api-Key: acc_your_key"
JavaScript
const res = await fetch("https://acceptororg.com/api/v1/balance", {
headers: { "X-Api-Key": "acc_your_key" },
});
const data = await res.json();Buy
POST /api/v1/buy
Charges that balance and places the order. Send an Idempotency-Key header to safely retry the same purchase.
curl
curl https://acceptororg.com/api/v1/buy \
-H "X-Api-Key: acc_your_key" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-1001" \
-d '{"country":"IT","tier":"old","quantity":1}'JavaScript
const res = await fetch("https://acceptororg.com/api/v1/buy", {
method: "POST",
headers: {
"X-Api-Key": "acc_your_key",
"Content-Type": "application/json",
"Idempotency-Key": "order-1001",
},
body: JSON.stringify({ country: "IT", tier: "old", quantity: 1 }),
});
const data = await res.json();Order status
GET /api/v1/orders/:id
Returns status for one of your orders. When download_url is set, call that address with the same API key. It is our download proxy, never a supplier URL.
curl
curl https://acceptororg.com/api/v1/orders/ORDER_ID \ -H "X-Api-Key: acc_your_key"
JavaScript
const res = await fetch("https://acceptororg.com/api/v1/orders/ORDER_ID", {
headers: { "X-Api-Key": "acc_your_key" },
});
const data = await res.json();Rate limit
Each key allows 60 requests per minute unless a different limit is set. Extra requests return 429.
Error codes
unauthorized
Missing, unknown, or revoked key.
rate_limited
Too many requests this minute.
invalid_request
The query or body is missing a field or has a bad value.
not_found
That order does not belong to this key.
insufficient_balance
The balance cannot cover the order.
out_of_stock
Not enough stock for the quantity.
price_unavailable
That country and tier are not for sale.
price_increased
The live price is higher than the quoted price. Nothing was charged.
unverified
Live stock could not be checked. Nothing was charged.
sourcing_failed
The supplier rejected the order. The balance was refunded.
idempotency_conflict
This Idempotency-Key was already used for a different request.
idempotency_in_progress
The same Idempotency-Key is still running.
unavailable
The API database is not ready.