API Documentation

DEVELOPER ACCESS

Your website. Our service catalog.

Available to approved resellers when API access is enabled.

Quick start

Base URL: https://bimaz.xyz/wp-json/gsm/v1/

Use HTTPS and an Authorization: Bearer YOUR_KEY header. Keep your key on your server. Limit: 60 requests per minute per account.

Method	Path	Purpose
GET	services?page=1	Catalog and account prices; up to 50 services per page
GET	services/{id}	Current price and required fields
POST	order	Create an order with an Idempotency-Key header
GET	order/{id}	Read your order status and result
GET	balance	Available account balance

Order JSON (use the current catalog price as a string):

{
  "service_id": 1,
  "expected_price": "2.8000",
  "input": { "imei": "490154203237518", "scenario": "complete" }
}

Use a unique Idempotency-Key of 16–120 letters, digits, periods, underscores, colons or hyphens. Retry an uncertain request with exactly the same key and body. A changed body with an old key returns 409. Read status until the order reaches a final state.

Money values are strings with four decimal places. Results contain your local order ID and customer price. File-based services currently require uploading through the customer website; the reseller API does not expose an upload endpoint.