Prices

Beta

3 endpoints, each naming the scope its key must carry.

https://api.ghostsms.iov1openapi.json

GET /v1/prices

scopeservices:read

List prices: every service in a country, or every country for a service

Query parameters

countrystring
servicestring

Returns

objectstring
dataarray of price: objectstring
countrystring
servicestring
availableboolean
unavailable_reasonstring
priceapimoney
stockinteger
quote_tokenstring
quote_expires_attimestamp
has_moreboolean
next_cursorstring

curl https://api.ghostsms.io/v1/prices \
  -H "Authorization: Bearer $GHOSTSMS_KEY"

200

{
  "object": "activation",
  "data": [
    {
      "object": "activation",
      "country": "…",
      "service": "…",
      "available": false,
      "unavailable_reason": "…",
      "price": "…",
      "stock": 0,
      "quote_token": "…",
      "quote_expires_at": "2026-09-18T10:35:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": "…"
}

GET /v1/rental-prices

scopeservices:read

List the rental durations offered in a country, with their prices

Query parameters

countrystringRequired

Returns

objectstring
dataarray of rentalprice: objectstring
countrystring
duration_hoursinteger
labelstring
priceapimoney
has_moreboolean
next_cursorstring

curl https://api.ghostsms.io/v1/rental-prices \
  -H "Authorization: Bearer $GHOSTSMS_KEY"

200

{
  "object": "activation",
  "data": [
    {
      "object": "activation",
      "country": "…",
      "duration_hours": 0,
      "label": "…",
      "price": "…"
    }
  ],
  "has_more": false,
  "next_cursor": "…"
}

GET /v1/prices/{country}/{service}

scopeservices:read

Price one service in one country, with a token that holds the price for a purchase

Returns

objectstring
countrystring
servicestring
availableboolean
unavailable_reasonstring
priceapimoney: amountinteger
currencystring
stockinteger
quote_tokenstring
quote_expires_attimestamp

curl https://api.ghostsms.io/v1/prices/{country}/{service} \
  -H "Authorization: Bearer $GHOSTSMS_KEY"

200

{
  "object": "activation",
  "country": "…",
  "service": "…",
  "available": false,
  "unavailable_reason": "…",
  "price": {
    "amount": 0,
    "currency": "…"
  },
  "stock": 0,
  "quote_token": "…",
  "quote_expires_at": "2026-09-18T10:35:00Z"
}