Skip to content
clearance.rest

Get Hero SMS price and stock

GET
/providers/herosms/prices
curl --request GET \
  --url 'https://api.clearance.rest/numbers/providers/herosms/prices?country=1&service=tg' \
  --header 'X-API-Key: <X-API-Key>'

Bulk price and stock for a country and service. Hero SMS does not list individual numbers before you rent, so this returns aggregates instead. cost is indicative, not a guaranteed floor.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Query Parameters

Section titled “Query Parameters”
country
required
integer

Hero SMS numeric country id.

service
required
string

Service code.

Responses

Section titled “Responses”

200

Section titled “200”

Price and stock.

Media typeapplication/json
object
success
required
boolean
prices
required
object
country
integer
service
string
cost

Indicative price per activation.

number
count

Numbers in stock.

integer
physicalCount

Of those, how many are physical SIMs.

integer
Example
{
  "success": true,
  "prices": {
    "country": 6,
    "service": "tg",
    "cost": 0.2,
    "count": 1500,
    "physicalCount": 40
  }
}

400

Section titled “400”

country or service is missing.

Media typeapplication/json

Error envelope returned with a non-2xx status.

object
success
required
boolean
error
required

Human-readable error message.

string
Example
{
  "success": false,
  "error": "invalid json body"
}

401

Section titled “401”

The X-API-Key header is missing or invalid.

Media typeapplication/json

Error envelope returned with a non-2xx status.

object
success
required
boolean
error
required

Human-readable error message.

string
Example
{
  "success": false,
  "error": "geçersiz API anahtarı"
}

502

Section titled “502”

The upstream provider call failed (network error, auth error, or the provider’s own error).

Media typeapplication/json

Error envelope returned with a non-2xx status.

object
success
required
boolean
error
required

Human-readable error message.

string
Example
{
  "success": false,
  "error": "invalid json body"
}