Developer API

Build with GotSMS

A simple, reliable HTTP API to rent numbers, receive SMS, and manage your account programmatically.

Get your API key

Enable API access in your GotSMS profile, then generate a personal API key.

Open API settings

REST over HTTPS

JSON in, JSON out. Bearer-token authentication.

Code samples

Copy-paste ready examples for cURL, PHP, JS, and Python.

Public & versioned

The public pricelist endpoint needs no key at all; account endpoints are versioned and backwards-compatible.

GET /api/pricelist

# Request
curl https://app.gotsms.org/api/pricelist

# Response
{
  "success": true,
  "data": [
    {
      "id": "9a74...f90",
      "name": "Telegram",
      "slug": "telegram",
      "plans": [ ... ]
    }
  ]
}

Full reference

Every endpoint, every field, with interactive examples — generated straight from the source.

Authentication
Rents, Services, Messages
Transactions
Error codes

Open API documentation

Sign in

Go through a quick registration without verification, and use our service.