API Documentation

GET https://tempcode77.com/api/services.php

Returns all services. Each item includes service_id, name, and (from our categorization) type and type_label (e.g. social_media, messaging, shopping).

Query parameters

type	Optional. Filter by category: social_media, messaging, shopping, banking, email, gaming, streaming, travel, food, dating, other.
grouped	Optional. Set to 1 to get by_type (slug → { label, services[] }) and types (slug, label) for building category filters.

Example

curl -X GET "https://tempcode77.com/api/services.php?grouped=1"

GET https://tempcode77.com/api/countries.php

Returns all countries. Each item has country_id and name.

Example

curl -X GET "https://tempcode77.com/api/countries.php"

GET path=wallet

Returns your wallet balance in cents. Optionally include transaction history.

Query parameters

transactions	Optional. Set to 1 or any non-empty value to include the last 20 wallet transactions in the response.

Response (200)

{
  "ok": true,
  "data": {
    "balance_cents": 12500,
    "transactions": [
      {
        "type": "deposit",
        "amount_cents": 1000,
        "balance_after_cents": 12500,
        "description": "Deposit",
        "created_at": "2025-02-15 12:00:00"
      }
    ]
  }
}

Example

curl -X GET "https://tempcode77.com/api/v1/index.php?path=wallet" \
  -H "X-Api-Key: YOUR_API_KEY"

GET path=price&service_id={service_id}&country_id={country_id}

Returns the platform price (including our markup) for a single service and country. Also returns backend (Platfone) cost and availability. Cached for 90 seconds. For lists of prices (e.g. all countries for a service, or all services for a country), use the bulk endpoints below to get everything in one call (60s cache).

Query parameters

service_id	Required. Service ID (e.g. whatsapp, telegram). Alphanumeric, dashes, underscores; 1–30 chars.
country_id	Required. Country ID (e.g. us, uk). 2–9 chars.

Response (200)

{
  "ok": true,
  "data": {
    "price": {
      "suggested": 287,
      "min": 210,
      "max": 510
    },
    "backend_cents": 260,
    "sell_price_cents": 287,
    "count": 124335
  }
}

sell_price_cents is what you pay when you create an activation. backend_cents is the Platfone cost we use for the order.

Example

curl -X GET "https://tempcode77.com/api/v1/index.php?path=price&service_id=whatsapp&country_id=us" \
  -H "X-Api-Key: YOUR_API_KEY"

GET path=prices/by-service&service_id={service_id}

Returns all countries and their platform prices for one service (e.g. WhatsApp). One request returns the full list so you avoid many single-price calls. Responses are cached for 60 seconds to keep prices fresh while limiting upstream API calls.

Query parameters

service_id	Required. Service ID (e.g. whatsapp, telegram).

Response (200)

data is an array; the first element has service_id, name, and countries (array of { country_id, name, price: { suggested, min, max }, backend_cents, sell_price_cents }).

Example

curl -X GET "https://tempcode77.com/api/v1/index.php?path=prices/by-service&service_id=whatsapp" \
  -H "X-Api-Key: YOUR_API_KEY"

GET path=prices/by-country&country_id={country_id}

Returns all services and their platform prices for one country (e.g. US). One request returns the full list. Cached for 60 seconds.

Query parameters

country_id	Required. Country ID (e.g. us, uk).

Response (200)

data is an array; the first element has country_id, name, and services (array of { service_id, name, price: { suggested, min, max }, backend_cents, sell_price_cents }).

Example

curl -X GET "https://tempcode77.com/api/v1/index.php?path=prices/by-country&country_id=us" \
  -H "X-Api-Key: YOUR_API_KEY"

GET path=activations

Returns a paginated list of your activations (most recent first).

Query parameters

page	Optional. Page number (default 1).
limit	Optional. Items per page, 1–50 (default 20).

Response (200)

{
  "ok": true,
  "data": {
    "activations": [
      {
        "id": 42,
        "activation_id": "abc123...",
        "phone": "+14155551234",
        "country_id": "us",
        "service_id": "whatsapp",
        "price_cents": 260,
        "sell_price_cents": 287,
        "sms_status": "smsRequested",
        "activation_status": "active",
        "created_at": "2025-02-15 12:00:00"
      }
    ],
    "page": 1,
    "limit": 20,
    "total": 1
  }
}

Example

curl -X GET "https://tempcode77.com/api/v1/index.php?path=activations&page=1&limit=10" \
  -H "X-Api-Key: YOUR_API_KEY"

POST path=activations

Orders a phone number for the given service and country. You are charged when the SMS is received (see Poll activation).

Request body (JSON or form)

service_id	Required. Service ID (e.g. whatsapp).
country_id	Required. Country ID (e.g. us).
max_price	Optional. Max you are willing to pay (USD cents, 1–10000). Defaults to current suggested price.

Response (200)

{
  "ok": true,
  "data": {
    "id": 43,
    "activation_id": "platfone_activation_id",
    "phone": "+14155551234",
    "country_id": "us",
    "service_id": "whatsapp",
    "sell_price_cents": 287,
    "price_cents": 260
  }
}

Use the returned id (our internal ID) for path=activations/{id}, path=activations/{id}/poll, and path=activations/{id}/cancel.

Example

curl -X POST "https://tempcode77.com/api/v1/index.php?path=activations" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service_id": "whatsapp", "country_id": "us"}'

GET path=activations/{id}

Returns a single activation by our internal id (returned when you create an activation). This endpoint syncs from Platfone before returning, so you get the latest state (including sms_code and sms_text when the SMS has been received). You can use either Get activation or Poll activation to retrieve the code; both update our DB and charge your wallet once when SMS is received.

Path

{id} — integer ID of the activation (e.g. path=activations/43).

Response (200)

{
  "ok": true,
  "data": {
    "id": 43,
    "activation_id": "...",
    "phone": "+14155551234",
    "country_id": "us",
    "service_id": "whatsapp",
    "price_cents": 260,
    "sell_price_cents": 287,
    "sms_status": "smsReceived",
    "activation_status": "active",
    "billing_status": "billed",
    "sms_code": "123456",
    "sms_text": "Your code is 123456",
    "expire_at": 1730123456,
    "is_retriable": true
  }
}

Example

curl -X GET "https://tempcode77.com/api/v1/index.php?path=activations/43" \
  -H "X-Api-Key: YOUR_API_KEY"

GET path=activations/{id}/poll

Fetches the latest activation state from Platfone and updates our DB. When sms_status becomes smsReceived or retryReceived, your wallet is charged sell_price_cents (once per activation). Poll every 5–10 seconds until you get the SMS or the activation expires.

Path

{id} — our internal activation ID (e.g. path=activations/43/poll).

Response (200)

{
  "ok": true,
  "data": {
    "phone": "+14155551234",
    "sms_status": "smsReceived",
    "activation_status": "active",
    "sms_code": "123456",
    "sms_text": "Your code is 123456",
    "expired": false
  }
}

sms_status: smsRequested (waiting), smsReceived (first SMS), retryRequested, retryReceived. When smsReceived or retryReceived, sms_code and sms_text are set and you have been charged.

Example

curl -X GET "https://tempcode77.com/api/v1/index.php?path=activations/43/poll" \
  -H "X-Api-Key: YOUR_API_KEY"

POST path=activations/{id}/cancel

Cancels the activation. If you were already charged (SMS received), the amount is refunded to your wallet.

Path

{id} — our internal activation ID (e.g. path=activations/43/cancel).

Response (200)

{
  "ok": true,
  "data": {
    "result": "canceled"
  }
}

Example

curl -X POST "https://tempcode77.com/api/v1/index.php?path=activations/43/cancel" \
  -H "X-Api-Key: YOUR_API_KEY"