Skip to main content

Services

Get a list of all available service codes for SMS reception.

Get Services List

Returns a list of every active service. Sub-variants (slugs containing -) are excluded. Use the code value as service_code when purchasing a number (POST /numbers/) or as the service filter when searching availability (GET /numbers/search/).

Endpoint

GET /api/v1/numbers/services/

Request

curl -X 'GET' \
'https://app.cyberyozh.com/api/v1/numbers/services/' \
-H 'accept: application/json' \
-H 'X-Api-Key: your_api_key_here'

Response

[
{
"name": "Twitter",
"code": "tw",
"provider": "virtual"
},
{
"name": "eBay",
"code": "dh",
"provider": "virtual"
},
{
"name": "Naver",
"code": "nv",
"provider": "virtual"
},
{
"name": "Telegram",
"code": "tg",
"provider": "residential"
}
]

Response Fields

FieldTypeDescription
namestringService display name (e.g. Telegram)
codestringService code for use in API requests (e.g. tg)
providerstringAssociated provider type (virtual, residential, or residential_rent)

Usage Example

import requests

headers = {
'accept': 'application/json',
'X-Api-Key': 'your_api_key_here'
}

response = requests.get(
'https://app.cyberyozh.com/api/v1/numbers/services/',
headers=headers
)

services = response.json()

# Find Telegram
telegram = next(s for s in services if s['code'] == 'tg')
print(f"Service: {telegram['name']} (code: {telegram['code']}, provider: {telegram['provider']})")

Notes

  • Service codes are used in the /search/ and /numbers/ endpoints
  • Not all services are available in all countries
  • Use the /search/ endpoint to check availability for specific country-service combinations