Reseller API

Getting started

Create an account, then open Account and generate an API key. The key is shown once, so store it safely. Anyone with the key can spend your balance.

Endpoint

https://mireon.xyz/api/v2

Method

POST, form encoded

Response

JSON

Rate limit

180 requests per minute per key

Every request needs key and action. Errors come back as {"error": "message"}.

Service list

Parameters: action=services

curl -s https://mireon.xyz/api/v2 -d "key=YOUR_KEY" -d "action=services"

[{"service":"12","name":"Example service","type":"Default","category":"Example","rate":"0.4200","min":"100","max":"10000","refill":true,"cancel":false}]

The rate is the price per 1,000 units in your account currency, with any personal discount already applied.

Add an order

Parameters: action=add, service, link, quantity

curl -s https://mireon.xyz/api/v2 -d "key=YOUR_KEY" -d "action=add" -d "service=12" -d "link=https://example.com/post" -d "quantity=1000"

{"order": 23501}

The charge is taken from your balance immediately. If the order cannot be started, the charge is refunded and the order ends as canceled.

Order status

Parameters: action=status with order, or orders as a comma separated list of up to 100 ids.

{"charge":"0.4200","start_count":"3572","status":"Partial","remains":"157","currency":"NGN"}

Statuses are Pending, Processing, In progress, Completed, Partial and Canceled. For partial and canceled orders the charge already reflects the refund.

Balance and refill

action=balance returns {"balance":"100.8400","currency":"NGN"}.

action=refill with order requests a refill for a completed order whose service includes one. It returns {"refill":"1"}.

Good practice

• Do not retry an add request that timed out without checking your orders first, or you may be charged twice.
• Poll status sparingly. Checking each order every few minutes is plenty.
• Resellers are responsible for what their own customers order. See the Acceptable Use Policy.