API v1

Base URL: https://sim.codediera.com/api/v1

Getting Started

1. Sign up or log in to your account.
2. Open Profile → API Access.
3. Click “Generate API Token” and copy the token immediately.
4. Add the header Authorization: Bearer <YOUR_TOKEN> to every request.

To revoke a token, go back to Profile → API Access and click Revoke next to that token.

Authentication

Bearer Use a Laravel Sanctum Personal Access Token.

Header: Authorization: Bearer <YOUR_TOKEN>

Endpoints

GET /services/smm — list SMM services

• Query: category, type

GET /services/sms/countries — list available SMS countries

GET /services/sms — list SMS services or prices

• Query: country_id — when present, returns pricing and stock for that country

GET /services/virtual-numbers — list virtual numbers

• Query: country_id, service_code, provider, status

GET /me — verify token and get your profile

Examples

cURL:

curl -H "Accept: application/json" \
-H "Authorization: Bearer YOUR_TOKEN" \
"https://sim.codediera.com/api/v1/services/smm?category=Instagram"

JavaScript (fetch):

fetch("https://sim.codediera.com/api/v1/services/sms?country_id=1", {
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN"
  }
}).then(r => r.json()).then(console.log);

PHP (Guzzle):

$client = new \GuzzleHttp\Client([
  'base_uri' => 'https://sim.codediera.com/api/v1',
  'headers' => ['Authorization' => 'Bearer YOUR_TOKEN', 'Accept' => 'application/json'],
]);
$res = $client->get('/services/virtual-numbers', ['query' => ['status' => 'available']]);
echo $res->getBody();

Python (requests):

import requests
BASE = "https://sim.codediera.com/api/v1"
headers = {"Authorization": "Bearer YOUR_TOKEN", "Accept":"application/json"}
r = requests.get(f"{BASE}/services/sms/countries", headers=headers)
print(r.json())

Responses

Successful response format:

{
  "ok": true,
  "data": [...]
}

Error examples:

• 401 Unauthorized — missing/invalid token
• 429 Too Many Requests — rate limited

Get a Token

Create a Personal Access Token for your account and include it as a Bearer token in requests.

Status

This API is read‑only. If you need ordering endpoints, contact support to enable write operations with balance checks and idempotency.