Integration API Documentation

Welcome to the official developer integration API documentation for Tools Market Shop. This programmatic JSON API allows resellers, developers, and automated scripts to interface directly with our Telegram bot to fetch account status and submit cloud activation requests.

Base Server URL

https://your-domain.ngrok-free.app

Authentication

To authenticate requests, you must pass your unique integration API key in the headers as X-API-Key. You can generate or rotate your API key at any time in the Telegram bot by issuing the /api command or navigating to the Profile → API Key menu.

Example Request Header 
X-API-Key: tools_28d9c3aef7e01b7a2d48bf56012c83d9a0d8e841

Get Balance & User Info

Fetch details about your account, including current balance (in USD), reseller status, activation costs, and success metrics.

GET /api/v1/balance

Headers

Name Type Description
X-API-Key string required Your secure developer API key.

cURL Command Example

Bash curl 
curl -X GET "https://your-domain.ngrok-free.app/api/v1/balance" \
  -H "X-API-Key: YOUR_API_KEY"

Successful Response (JSON)

HTTP 200 OK 
{
  "ok": true,
  "user_id": 5145264491,
  "username": "Qusay_Dev",
  "balance": 185.50,
  "success_count": 48,
  "fail_count": 2,
  "is_reseller": true,
  "activate_price": 2.00
}

Submit Activation

Programmatically submit a new Google One 5TB 12-Month activation task. This will automatically deduct the activation cost from your reseller balance and enqueue the job on our processing nodes.

POST /api/v1/activate

JSON Body Parameters

Parameter Type Description
email string required Target Google account email (must be a valid Gmail).
password string required Target Gmail password.
totp string required Base32 encoded 2FA secret key (e.g. JBSWY3DPEHPK3PXP).

cURL Command Example

Bash curl 
curl -X POST "https://your-domain.ngrok-free.app/api/v1/activate" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "customer@gmail.com",
    "password": "securepassword123",
    "totp": "JBSWY3DPEHPK3PXP"
  }'

Successful Response (JSON)

HTTP 200 OK 
{
  "ok": true,
  "job_id": "job_17e01b7a2d48bf56",
  "tx_id": "B8DF4A9C",
  "queue_position": 2,
  "estimated_wait_seconds": 120
}

Check Job Status

Query the live status, queue position, or final outcomes of any activation task. You must query using either the job_id or the transaction tx_id returned when submitting the activation.

GET /api/v1/status

Query Parameters

Parameter Type Description
job_id string optional Unique identifier of the task returned by the activate endpoint.
tx_id string optional Human-readable 8-char transaction identifier (e.g. B8DF4A9C).

💡 Note: You must supply at least one of these two identifiers.

cURL Command Example

Bash curl 
curl -X GET "https://your-domain.ngrok-free.app/api/v1/status?job_id=job_17e01b7a2d48bf56" \
  -H "X-API-Key: YOUR_API_KEY"

Processing Response

HTTP 200 OK — In Queue 
{
  "ok": true,
  "status": "PROCESSING",
  "job_id": "job_17e01b7a2d48bf56",
  "tx_id": "B8DF4A9C",
  "email": "customer@gmail.com",
  "submitted_at": 1775835150,
  "live_state": "RUNNING",
  "stage_label": "Verifying Credentials",
  "queue_position": 1
}

Completed Response

HTTP 200 OK — Successful 
{
  "ok": true,
  "status": "COMPLETED",
  "job_id": "job_17e01b7a2d48bf56",
  "tx_id": "B8DF4A9C",
  "email": "customer@gmail.com",
  "outcome": "SUCCESS",
  "url": "https://one.google.com/promo/claim/invite_code_example",
  "error_reason": null,
  "timestamp": "2026-06-04 23:55:00"
}

Get Product Catalog

Retrieve the complete list of active, non-hidden products in the store catalog. Programmatic clients can use this to sync product IDs, current pricing, available stock, and bulk/tier pricing rules.

GET /api/v1/products

Headers

Header Type Description
X-API-Key string required Your unique integration API Key.

cURL Command Example

Bash curl 
curl -X GET "https://your-domain.ngrok-free.app/api/v1/products" \
  -H "X-API-Key: YOUR_API_KEY"

Response Example

HTTP 200 OK 
{
  "ok": true,
  "products": [
    {
      "product_id": 55,
      "name": "Gemini Pro 18 months Activation Link",
      "price": 10.0,
      "stock": 13,
      "category": "Google",
      "delivery_type": "codes",
      "auto_delivery": 1,
      "out_of_stock_option": "wait_restock",
      "bulk_pricing": [
        {
          "min_qty": 5,
          "price": 9.5
        },
        {
          "min_qty": 10,
          "price": 9.0
        }
      ]
    }
  ]
}

Purchase Product

Purchase code-based (auto-delivery) items or submit order tickets programmatically. If the product delivery type is auto-delivery (codes), it returns the claimed and delivered keys instantly. If there is insufficient stock for a codes product, it returns a 400 error to prevent reseller balance lock.

POST /api/v1/buy

JSON Payload parameters

Field Type Description
product_id integer required ID of the product to purchase.
quantity integer optional Number of licenses to purchase. Defaults to 1.

cURL Command Example

Bash curl 
curl -X POST "https://your-domain.ngrok-free.app/api/v1/buy" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"product_id": 55, "quantity": 1}'

Response Example

HTTP 200 OK — Success 
{
  "ok": true,
  "product_id": 55,
  "product_name": "Gemini Pro 18 months Activation Link",
  "quantity": 1,
  "total_cost": 10.0,
  "new_balance": 45.0,
  "delivery_type": "codes",
  "codes": [
    "https://one.google.com/promo/claim/invite_code_example"
  ]
}

Interactive API Playground

Test requests directly in your browser. Enter your credentials to call endpoints on this server instance.

Response Headers & Body

{}