📚 API Documentation

Integrate with your Telegram bot or any system using these endpoints.

Base URL & Authentication

POST https://your-domain.com/api/v1/{endpoint}

All requests must include your cdkey in the JSON body.

Content-Type: application/json
{
  "cdkey": "YOUR-CDK-CODE",
  ...other params
}

POST/api/v1/balance

Check remaining points for your CDK code.

REQUEST

{ "cdkey": "DS-A7X9K2B4" }

RESPONSE

{ "success": true, "remaining_uses": 45.0 }

POST/api/v1/submit

Submit a new activation order.

ParamTypeRequiredDescription
cdkeystringrequiredYour CDK code
emailstringrequiredGmail account
passwordstringrequiredAccount password
twofastringoptional2FA secret key
task_typestringrequired"full" (2 pts) or "extract" (1 pt)

RESPONSE

{
  "success": true,
  "message": "Order submitted successfully",
  "order_id": 1024,
  "remaining_uses": 43.0
}

POST/api/v1/status

Check order status.

{ "cdkey": "DS-A7X9K2B4", "order_id": 1024 }

RESPONSE

{
  "success": true,
  "data": {
    "order_id": 1024,
    "email": "user@gmail.com",
    "status": "success",
    "message": "Activated",
    "offer_url": "",
    "has_offer_url": false,
    "task_type": "full",
    "created_at": "2026-05-16T15:00:00Z"
  }
}

POST/api/v1/cancel

Cancel a pending order (points refunded).

{ "cdkey": "DS-A7X9K2B4", "order_id": 1024 }

RESPONSE

{ "success": true, "message": "Order cancelled and points refunded", "remaining_uses": 45.0 }

POST/api/v1/purchase_link

Buy activation link from a failed order (costs 1 point).

{ "cdkey": "DS-A7X9K2B4", "order_id": 1024 }

RESPONSE

{
  "success": true,
  "offer_url": "https://support.google.com/...",
  "remaining_uses": 44.0
}

POST/api/v1/orders

Get all your orders (optional filter by status).

{ "cdkey": "DS-A7X9K2B4", "status": "success" }

POST/api/v1/webhook

Set webhook URL for order status notifications.

{ "cdkey": "DS-A7X9K2B4", "webhook_url": "https://your-bot.com/hook" }

WEBHOOK PAYLOAD

{
  "event": "order.updated",
  "order": {
    "id": 1024,
    "email": "user@gmail.com",
    "status": "success",
    "task_type": "full",
    "message": "Activated",
    "offer_url": "",
    "has_offer_url": false
  },
  "timestamp": "2026-05-16T15:00:00Z"
}

💻 Code Examples

Python

import requests

API = "https://your-domain.com/api/v1"
CDK = "DS-A7X9K2B4"

# Submit order
r = requests.post(f"{API}/submit", json={
    "cdkey": CDK,
    "email": "user@gmail.com",
    "password": "pass123",
    "twofa": "SECRET",
    "task_type": "full"
})
print(r.json())

Node.js

const res = await fetch('https://your-domain.com/api/v1/submit', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
        cdkey: 'DS-A7X9K2B4',
        email: 'user@gmail.com',
        password: 'pass123',
        task_type: 'full'
    })
});
console.log(await res.json());

cURL

curl -X POST https://your-domain.com/api/v1/submit \
  -H "Content-Type: application/json" \
  -d '{"cdkey":"DS-A7X9K2B4","email":"user@gmail.com","password":"pass123","task_type":"full"}'