RagoxCell API for developers

2 min read

RagoxCell offers a simple REST API so your website can register repair orders and create shipping labels for mail-in repairs. This guide is for developers.

Authentication

Create an API key in your dashboard under Settings → API access. The key is shown once — store it securely on your server (never expose it in browser code).

Send it as a Bearer token on every request:

Authorization: Bearer rxk_live_xxxxxxxxxxxxxxxx

The base URL is https://ragoxcell.com/api/v1. Requests are rate-limited per key.

Create an order

POST /api/v1/orders

{
  "customer": { "name": "Jane Doe", "email": "jane@example.com", "phone": "+17275551234" },
  "device": { "kind": "phone", "brand": "Apple", "model": "iPhone 13" },
  "reportedIssue": "Cracked screen, touch works"
}

device.kind is one of phone, laptop, tablet, desktop, other. The response returns a trackingCode and ticketNumber.

Check order status

GET /api/v1/orders/{trackingCode} — returns the current status, device and ticket number.

Get shipping rates

POST /api/v1/shipping/rates (requires a connected Shippo account under Settings → Shipping)

{
  "to": { "name": "Jane Doe", "street1": "1 Main St", "city": "Tampa", "state": "FL", "zip": "33601", "country": "US" },
  "parcel": { "length": 9, "width": 6, "height": 3, "weight": 1 }
}

Returns an array of rates, each with an id, provider (USPS/UPS/FedEx…), service, amountCents and currency.

Buy a shipping label

POST /api/v1/shipping/labels

{ "rateId": "<a rate id from /shipping/rates>", "orderTrackingCode": "RX-7Q2K", "direction": "inbound" }

Returns the purchased label URL and tracking number. Use direction: "inbound" for a prepaid label your customer uses to mail their device to you.

Errors

Errors return a JSON body { "error": "..." } with an HTTP status (401 invalid key, 412 shipping not configured, 400 bad input, 429 rate limited).

Need help integrating? Contact us.