Developer API · v1

Resell 95+ device checks by API.

One key, one endpoint. Run any Sickw-backed check — blacklist, iCloud, carrier, SIM-lock, warranty, model info — against an IMEI and get structured JSON back. Pay per check in credits. No subscription, no minimums.

Create account Sign in Read the docs

Quick start

# 1. list services + prices
curl https://devicedecoded.com/api/v1/checks/services

# 2. run a check
curl -X POST https://devicedecoded.com/api/v1/checks \
  -H "X-API-Key: YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"imei":"356938035643809","service":6}'

Services

95+

Billing

Per check

Response

JSON

Auth

API key

Base URL

https://devicedecoded.com/api/v1

All endpoints are relative to this base. Requests and responses are JSON.

Authentication

Send your key in the X-API-Key header on every POST /checks request. Generate or revoke your key from your dashboard (create an account first if you don't have one). The price list (GET /checks/services) is public and needs no key.

Endpoints

GET /api/v1/checks/services No key required

Returns every service with its credit price. Use the service id when running a check.

Response 200

{
  "services": [
    { "service": 3, "name": "iCloud On/off", "category": "apple", "credits": 3, "instant": true },
    { "service": 6, "name": "WW Blacklist Status — Pro", "category": "blacklist", "credits": 3, "instant": true }
  ]
}

credits: What this service costs to run (1 credit ≈ £1).
instant: Info/status lookups return in seconds. Non-instant services are premium/unlock fulfilment.

POST /api/v1/checks X-API-Key

Runs a service against an IMEI and returns the result. You are charged the service's credits only on success — a not-found or provider-down lookup is never billed.

Request body

{
  "imei": "356938035643809",   // 8–20 chars, required
  "service": 6                 // service id from /checks/services, required
}

Response 200

{
  "service": 6,
  "service_name": "WW Blacklist Status — Pro",
  "imei": "356938035643809",
  "credits_used": 3,
  "credit_balance": 97,
  "result": {
    "Blacklist Status": "Clean"
  },
  "summary": {
    "blacklist_clean": true
  }
}

The result fields vary by service. summary holds normalised booleans/values where available.

Status codes

Code	Meaning	Charged?
200	Check ran — result returned.	Yes (service credits)
401	Invalid or missing `X-API-Key`.	No
402	Insufficient credits. Response includes `required` and `balance`.	No
404	Unknown `service` id.	No
422	Validation failed, or no result for this IMEI on this service.	No

Credits & billing

· Each service has a fixed credit price (1 credit ≈ £1). See /checks/services.
· Failed or empty lookups are never charged.
· Buy credits in blocks and enable auto top-up so you never run dry mid-batch.

Managing your key

· Generate one key per account from the dashboard.
· Regenerating replaces the old key immediately — update your integration.
· Revoke instantly if a key leaks. Every request is logged for auditing.

Create account