SMS Activate Logo

Guía para desarrolladores

Documentación para desarrolladores

SMS Activate ofrece una API totalmente automatizada para usuarios que necesitan alquilar números de teléfono temporales a gran escala.

Create an API key in your dashboard and send it in the X-API-KEY header to https://api.smsactivate.uk. Order a number with POST /get_numbers using a service code and numeric country ID, then poll GET /status/{order_id} for the code. This API receives codes on a number you order. It does not send codes to your own users.

Empezar

Crea una clave de API en tu panel y úsala en una solicitud desde el servidor.

Nunca pongas una clave de API real en código del navegador, capturas de pantalla ni repositorios públicos.

Abrir claves de API

What does a first integration look like, end to end?

Start with GET /balance. A failed first call usually means the key or header is wrong.

Check what is live before you order: GET /services for service codes, GET /countries/{service} for country IDs, GET /offers/{service}/{country} for current offers. Availability changes; the catalog here is a reference, not a promise of stock. Browse all services.

POST /get_numbers with service and country. The response gives you an order id and a phone number; save the id.

Poll GET /status/{order_id} until the status reads received, then read sms_code.

What happens to an order after you place it?

An order moves through states, and what you can do depends on the state.

Active means the number is waiting for an SMS. While active you can ask for another SMS with POST /resend/{order_id} on a supported activation, or cancel an eligible one with POST /cancel/{order_id}. Cancel only works 2 to 20 minutes after purchase, and only before an SMS arrives.

Received means the code arrived. An expired order ran out its 20-minute window with no SMS and returns its stored status. An eligible activation that receives no SMS is refunded to your wallet. Read the FAQ.

Check the cancel response before you retry anything. If a purchase response is uncertain, do not order again until its status is clear. Contact support.

What mistakes cost first-time integrators the most?

Putting the key in browser code or a public repo. Keep it on a server you control.

Ordering before checking availability. GET /offers/{service}/{country} first saves a failed order.

Polling without a stop. GET /sms/{order_id} is rate-limited, so use GET /status/{order_id} and stop at a final state: received, cancelled, expired or refunded.

Retrying a purchase that came back uncertain. A 503 can mean the order went through and the answer got lost. Contact support.

Reusing an idempotency key for a different purchase. Use the same key only to check the outcome of the same purchase request.

Assuming the code will be accepted. Acceptance is the receiving service's decision, not ours.

Buying a one-time activation for an account that will ask for a code again - rentals are for that: 24 to 1,344 hours on the same number.

1. Autenticación

Obtén tu clave de API en la configuración de tu panel. Todas las solicitudes a la API deben incluir la cabecera:

X-API-KEY: your_api_key_here

2. URL base

Todas las solicitudes a la API usan esta URL base:

https://api.smsactivate.uk

Ejemplo de solicitud

Esta solicitud hace un pedido y puede cobrar tu monedero. Sustituye el servicio y el país de ejemplo por una selección disponible en tu cuenta.

curl -X POST https://api.smsactivate.uk/get_numbers   -H "X-API-KEY: YOUR_API_KEY"   -H "Content-Type: application/json"   -d '{"service":"tg","country":2}'

Referencia de la API

Cada operación incluye sus entradas, un ejemplo de solicitud, una respuesta representativa y los errores principales. Las integraciones de API existentes pueden seguir usando sus endpoints anteriores; los endpoints basados en producto de abajo se recomiendan para integraciones nuevas. Los ejemplos usan ID y valores de muestra. Envía las solicitudes autenticadas desde tu servidor con la cabecera de clave de API.

Empieza aquí

GET/balanceConsulta el saldo actual de tu monedero.

Se requiere clave de API.

Parámetros

Ninguno
Sin parámetros de consulta.

Ejemplo de solicitud

curl https://api.smsactivate.uk/balance -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{ "balance": "10.0000" }

Errors

El endpoint devuelve el saldo actual de la cuenta autenticada.

Obtener y gestionar un número

POST/get_numbersRealiza un pedido de activación.

Se requiere clave de API.

Parámetros

service
Cadena obligatoria. Código del servicio, por ejemplo tg.
country
Entero obligatorio. ID numérico del país.
operator
Cadena opcional. Por defecto, any.
max_price
Número opcional. Precio máximo; también se acepta maxPrice.
min_price
Número opcional; también se acepta minPrice.
any_price
Booleano opcional; también se acepta anyPrice.
product
Opcional: standard (por defecto) o api_links. Los API Links son compras de inventario de venta final.
idempotency_key
UUID opcional para activaciones estándar. Reutiliza la misma clave solo para la misma solicitud de compra cuando se esté comprobando su resultado.
quantity
Entero opcional de 1 a 100 para pedidos de inventario de API Links; por defecto 1. Los pedidos de activación estándar son de un solo número.

Ejemplo de solicitud

curl -X POST https://api.smsactivate.uk/get_numbers \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"tg","country":2}'

Respuesta

{
  "id": "ORDER_ID",
  "phone": "10000000000",
  "price": "0.2500",
  "balance_remaining": "9.7500"
}

Errors

HTTP 400: selección no disponible, límite de precio o saldo insuficiente. HTTP 409: un pedido anterior aún se está comprobando. HTTP 503: fallo temporal o pedido incierto; si la respuesta indica que se requiere reconciliación, no reintentes y contacta con soporte.

GET/sms/{order_id}Solicita una nueva comprobación de estado de un pedido activo.

Se requiere clave de API. Este endpoint tiene límite de solicitudes.

Parámetros

order_id
Valor de ruta obligatorio devuelto al crear el pedido.

Ejemplo de solicitud

curl https://api.smsactivate.uk/sms/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{
  "status": "received",
  "sms_code": "123456",
  "raw_sms": "Your verification code is 123456"
}

Errors

HTTP 400: la comprobación de SMS no está disponible para este pedido. HTTP 404: pedido no encontrado. HTTP 502: fallo temporal de la comprobación. Los pedidos caducados devuelven su estado guardado sin una nueva comprobación externa.

GET/status/{order_id}Consulta el estado de un pedido y los SMS recibidos.

Se requiere clave de API.

Parámetros

order_id
Valor de ruta obligatorio devuelto al crear el pedido.

Ejemplo de solicitud

curl https://api.smsactivate.uk/status/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{
  "status": "received",
  "sms_code": "123456",
  "raw_sms": "Your verification code is 123456"
}

Errors

La respuesta se limita al pedido de la cuenta autenticada. Si falla la consulta de estado, la API devuelve un error; revisa el ID del pedido e inténtalo más tarde si el servicio no está disponible temporalmente.

POST/resend/{order_id}Solicita otro SMS para una activación activa compatible.

Se requiere clave de API.

Parámetros

order_id
Valor de ruta obligatorio. Sin cuerpo de solicitud.

Ejemplo de solicitud

curl -X POST https://api.smsactivate.uk/resend/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{ "message": "Resend request successful. Waiting for new SMS." }

Errors

HTTP 400: reenvío no aceptado o pedido caducado. HTTP 409: el reenvío no está disponible para este pedido. HTTP 500: no se pudo completar el reenvío.

POST/cancel/{order_id}Solicita la cancelación de una activación elegible.

Se requiere clave de API.

Parámetros

order_id
Valor de ruta obligatorio. Sin cuerpo de solicitud.

Ejemplo de solicitud

curl -X POST https://api.smsactivate.uk/cancel/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{
  "message": "Number cancelled and balance refunded",
  "refunded_amount": "0.2500",
  "new_balance": "10.0000"
}

Errors

La cancelación solo está disponible para activaciones activas elegibles, entre 2 y 20 minutos después de la compra y antes de que llegue un SMS. Los alquileres usan /rent/cancel/{order_id}; los API Links son venta final. Las cancelaciones no elegibles o sin confirmar devuelven un error. Lee la respuesta de la cancelación antes de reintentar.

GET/reactivate/{order_id}/optionsConsulta el precio y los detalles actuales de la reactivación.

Se requiere clave de API.

Parámetros

order_id
Valor de ruta obligatorio del pedido original.

Ejemplo de solicitud

curl https://api.smsactivate.uk/reactivate/ORDER_ID/options -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{
  "price": 0.25,
  "duration": 20,
  "phone": "10000000000",
  "service": "tg",
  "country": 2
}

Errors

HTTP 400: la reactivación no es compatible o no está disponible. HTTP 409: la reactivación no está disponible para este pedido. HTTP 503: no se pudo confirmar un precio actual válido.

POST/reactivate/{order_id}Reactiva una activación elegible al precio actual.

Se requiere clave de API.

Parámetros

order_id
Valor de ruta obligatorio del pedido original. Sin cuerpo de solicitud.

Ejemplo de solicitud

curl -X POST https://api.smsactivate.uk/reactivate/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{
  "message": "Number reactivated successfully.",
  "id": "NEW_ORDER_ID",
  "phone": "10000000000",
  "price": 0.25,
  "balance_remaining": 9.75
}

Errors

HTTP 400: la reactivación no es compatible o el saldo del monedero es insuficiente. HTTP 409: no disponible para este pedido. HTTP 503: no se pudo confirmar el resultado; contacta con soporte antes de volver a intentarlo.

GET/orders/{order_id}Consulta los detalles de uno de tus pedidos.

Se requiere clave de API.

Parámetros

order_id
Valor de ruta obligatorio devuelto al crear el pedido.

Ejemplo de solicitud

curl https://api.smsactivate.uk/orders/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

Respuesta

Returns the order record with buyer-facing fields, including its status and remaining time where applicable. Internal routing IDs and cost fields are not returned.

Errors

HTTP 404: pedido no encontrado o no pertenece a tu cuenta.

Elegir servicios, países y precios

ServiciosBusca en el catálogo de servicios por nombre o código. La disponibilidad puede cambiar; consulta el endpoint en vivo antes de pedir.
Nombre / código1,638 entradas en el catálogo
  • 163COMwp
  • 11688hn
  • 11and1ahs
  • 11xbetwj
  • 224bettinglh
  • 22dehandsapd
  • 22domainserc
  • 22ememainblx
  • 22ГИСbcg
  • 332Redqi
  • 3360Krediayo
  • 33Funauw
  • 44FunLitehk
  • 5500pxfpx
  • 551exchboc
  • 551exchangeexc
  • 77-Elevenaws
  • 8888casinoll
  • 9999 Mdbrv
  • 99acresfw
  • 99appki
  • 999Gameqkb
  • 999k Outletamq
  • AA23acv
  • AA9Agn
  • AAadharhra
  • Abastece-aíanb
  • AAbbottags
  • Ace2Threerh
  • AAcimacim
  • AAckoamf
  • AdaKamiko
  • AAdaModalbdo
  • AAdanibq
  • AAdidasan
  • AAditya Birlaqff
  • AAdmiralBetbst
  • AAdobebyh
  • Advertsagw
  • AAEG Presentsrsn
  • AAffirmbow
  • AAfreecaTVaip
  • AGIBANKsa
  • AAgodaag
  • AgriDevelopcs
  • AAgroinformqu
  • AAhlanbsm
  • AAiqfomebbi
  • AAir Milesbsy
  • AAirba Freshbnp
  • Airbnbuk
  • AAirtaskerbyd
  • Airtelzl
  • AAirtimeacy
  • AISwv
  • AAIS PLAYaxs
  • Aitujj
  • Akudorf
  • Akulakutm
  • Alchemyaav
  • Alfabt
  • Alfagiftbn
  • AAlfamidibgt
  • AAlFursanbxr
  • AAlgidalp
  • AAlibabaab
  • AliExpresshx
  • AAlignableaul
  • Alipay/Alibaba/1688hw
  • All Accessajy
  • Allegroyn
  • AlloBanknh
  • AAllofreshaeo
  • AAltyn-ial
  • AAmap 高德地图btx
  • AAmarthaFinbsv
  • Amasiayo
  • AAmaze Super Appbzk
  • Amazonam
  • AAme Digitalafi
  • AAmwayaee
  • AAngel Oneaha
  • Ankamaalg
  • AAnnoncelightbyw
  • Any Otherot
  • AOLpm
  • ApostaGanhaml
  • Applewx
  • Apteka Aprelaeh
  • AptekaRUgk
  • AAptekiPlusrq
  • AAR Lensaco
  • ArenaPlusabt
  • AArgentamo
  • AAri10blq
  • AASAASbqr
  • AAsdahs
  • AAsiaMilesajp
  • AAsianDatingayb
  • AAskablebpi
  • AAspirationaptn
  • Astra Otoshopafd
  • AstraPayaem
  • Astropaygr
  • AASVLAbuj
  • AAti Subhl
  • AAtlas Earthawq
  • AAtlasbusatb
  • AttaPollanl
  • AAUBANKdu
  • Auchanst
  • AAudibleaud
  • AAukroaox
  • AAuthentifyccy
  • AAuthor24kd
  • AAutodeskbbl
  • Autoruaej
  • AAv100proajl
  • AAvitoav
  • AVONff

Disponibilidad en vivo y respuesta de ejemplo:

GET https://api.smsactivate.uk/services
{
  "services": ["tg", "wa", "go"],
  "providers": { "source-counts": "per active catalog" },
  "generated_at": "ISO 8601 timestamp"
}

El catálogo proporciona nombres y códigos para consulta. La disponibilidad es en vivo y puede diferir de esta lista; este JSON muestra la forma de la respuesta, no el inventario actual.

PaísesID numéricos de país del catálogo del panel. No hay un endpoint general de la API con la lista de países para activaciones estándar.
País / ID numérico206 entradas en el catálogo
  • Afghanistan74
  • Albania155
  • Algeria58
  • Angola76
  • Anguilla181
  • Antigua and Barbuda169
  • Argentina39
  • Armenia148
  • Aruba179
  • Australia175
  • Austria50
  • Azerbaijan35
  • Bahamas122
  • Bahrain145
  • Bangladesh60
  • Barbados118
  • Belarus51
  • Belgium82
  • Belize124
  • Benin120
  • Bermuda195
  • Bhutan158
  • Bolivia92
  • Bosnia108
  • Botswana123
  • Brazil73
  • Brunei121
  • Bulgaria83
  • Burkina Faso152
  • Burundi119
  • Cambodia24
  • Cameroon41
  • Canada36
  • Cape Verde186
  • Cayman Islands170
  • Central African Republic125
  • Chad42
  • Chile151
  • China3
  • Colombia33
  • Comoros133
  • Congo150
  • Costa Rica93
  • Croatia45
  • Cuba113
  • Cyprus77
  • Czech63
  • Denmark172
  • Djibouti168
  • Dominica126
  • Dominican Republic109
  • DR Congo18
  • Ecuador105
  • Egypt21
  • Equatorial Guinea167
  • Eritrea176
  • Estonia34
  • Ethiopia71
  • Faroe Islands202
  • Fiji189
  • Finland163
  • France78
  • French Guiana162
  • Gabon154
  • Gambia28
  • Georgia128
  • Germany43
  • Ghana38
  • Gibraltar201
  • Greece129
  • Grenada127
  • Guadeloupe160
  • Guatemala94
  • Guinea68
  • Guinea-Bissau130
  • Guyana131
  • Haiti26
  • Honduras88
  • Hong Kong14
  • Hungary84
  • Iceland132
  • India22
  • Indonesia6
  • Iran57
  • Iraq47
  • Ireland23
  • Israel13
  • Italy86
  • Ivory Coast27
  • Jamaica103
  • Japan182
  • Jersey194
  • Jordan116
  • Kazakhstan2
  • Kenya8
  • Kosovo203
  • Kuwait100
  • Kyrgyzstan11
  • Laos25
  • Latvia49
  • Lebanon153
  • Lesotho136
  • Liberia135
  • Libya102
  • Liechtenstein200
  • Lithuania44
  • Luxembourg165
  • Macao20
  • Madagascar17
  • Malawi137
  • Malaysia7
  • Maldives159
  • Mali69
  • Malta199
  • Mauritania114
  • Mauritius157
  • Mexico54
  • Moldova85
  • Monaco144
  • Mongolia72

Forma de la respuesta de ofertas para un servicio y un país:

[
  { "name": "any", "offers": [{ "price": 0.25, "count": 4 }] }
]

Los ID del catálogo identifican opciones de país, no garantizan ofertas en vivo. Consulta /offers/{service}/{country} para ver la disponibilidad.

GET/servicesConsulta la disponibilidad actual de los servicios.

Público: no requiere clave de API.

Parámetros

Ninguno
Este endpoint no admite parámetros de consulta.

Ejemplo de solicitud

curl https://api.smsactivate.uk/services

Respuesta

Returns the current services array and generated_at timestamp. See the searchable Services catalog below for code/name lookup; it is a maintained reference, not a live availability guarantee.

Errors

La disponibilidad puede cambiar. Consulta el endpoint en vivo y /offers/{service}/{country} antes de hacer un pedido.

GET/countries/{service}Lista los ID de país que tienen números para un servicio.

Público: no requiere clave de API.

Parámetros

service
Código de servicio obligatorio, como tg.

Ejemplo de solicitud

curl https://api.smsactivate.uk/countries/tg

Respuesta

{ "countries": [2, 6, 187] }

Errors

Los ID de país coinciden con el catálogo de países de abajo. La disponibilidad cambia; consulta /offers/{service}/{country} antes de pedir. Este endpoint tiene límite de solicitudes.

GET/offers/{service}/{country}/deliveryConsulta las tasas recientes de entrega de códigos por nivel de precio.

Público: no requiere clave de API.

Parámetros

service
Código de servicio obligatorio, como tg.
country
ID numérico de país obligatorio.

Ejemplo de solicitud

curl https://api.smsactivate.uk/offers/tg/2/delivery

Respuesta

{
  "window_days": 30,
  "tiers": { "0.2500": { "orders": 120, "codes": 108, "delivery_pct": 90, "best": true } }
}

Errors

HTTP 400: servicio o país no válido. No se listan los niveles sin códigos entregados. Los resultados se guardan en caché unos 5 minutos y cubren los últimos window_days días. Este endpoint tiene límite de solicitudes.

GET/operators?service={service}&country={country}Lista los operadores disponibles para un servicio y un país.

Público: no requiere clave de API.

Parámetros

service
Código de servicio obligatorio, como tg.
country
ID numérico de país obligatorio.

Ejemplo de solicitud

curl 'https://api.smsactivate.uk/operators?service=tg&country=2'

Respuesta

[
  { "name": "any", "localName": "Any Operator" },
  { "name": "example", "localName": "Example operator" }
]

Errors

La lista depende del país seleccionado y de la disponibilidad actual. Se requieren service y country; los valores ausentes o no válidos devuelven HTTP 422.

GET/offers/{service}/{country}Consulta las ofertas de una combinación de servicio y país.

Público: no requiere clave de API.

Parámetros

service
Valor de ruta obligatorio. Usa un código de servicio devuelto por /services, como tg.
country
Valor de ruta obligatorio. ID numérico de país; usa el catálogo de países del panel para activaciones estándar. No existe un endpoint general de la API que liste estos ID de país.

Ejemplo de solicitud

curl https://api.smsactivate.uk/offers/tg/2

Respuesta

[
  {
    "name": "any",
    "offers": [{ "price": "0.2500", "count": 4 }]
  }
]

Errors

Un par no compatible o no disponible puede devolver una lista vacía. Los datos de ofertas están en caché; un fallo de caché puede tardar más mientras se comprueba la disponibilidad.

Consultar la actividad anterior

GET/ordersConsulta tu historial de pedidos, del más reciente al más antiguo.

Se requiere clave de API.

Parámetros

page
Número de página opcional; por defecto 1.
per_page
Tamaño de página opcional; por defecto 20 y con tope de 100.
status
Opcional: active, completed (o received), cancelled, expired, refunded. Omítelo o usa all para incluir todos los estados.
search
Búsqueda opcional por número de teléfono.
category
Opcional: rents, links o numbers.

Ejemplo de solicitud

curl 'https://api.smsactivate.uk/orders?page=2&per_page=100&status=received&category=numbers' -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{
  "current_page": 2,
  "data": [{ "id": "ORDER_ID", "status": "received", "phone": "10000000000" }],
  "first_page_url": "…?page=1",
  "last_page": 4,
  "last_page_url": "…?page=4",
  "next_page_url": "…?page=3",
  "per_page": 100,
  "prev_page_url": "…?page=1",
  "total": 350
}

Errors

Sigue next_page_url hasta que sea null. page es 1 por defecto; per_page es 20 por defecto y sus valores se limitan a 1–100. status acepta active, completed/received, cancelled, expired o refunded; all o un valor desconocido deja status sin filtrar. search busca números de teléfono. category acepta rents, links o numbers; las categorías desconocidas se ignoran. Los historiales grandes requieren varias solicitudes de página.

Alquileres

GET/rent/servicesConsulta los servicios de alquiler para un país y una duración.

Se requiere clave de API.

Parámetros

country
ID de país entero opcional; por defecto 2.
duration
Horas opcionales; por defecto 24. Rango permitido: 24–1.344 horas.

Ejemplo de solicitud

curl 'https://api.smsactivate.uk/rent/services?country=2&duration=24' -H "X-API-KEY: YOUR_API_KEY"

Respuesta

Returns rental availability, with service codes and current prices for the selected country and duration.

Errors

HTTP 400: no hay número de alquiler disponible para la selección. HTTP 422: país o duración no válidos. HTTP 503: catálogo de alquileres no disponible temporalmente.

POST/rent/orderRealiza un pedido de alquiler.

Se requiere clave de API.

Parámetros

service
Código de servicio obligatorio (cadena).
country
ID de país obligatorio (entero).
duration
Horas obligatorias, de 24 a 1.344.
operator
Cadena opcional; por defecto any.

Ejemplo de solicitud

curl -X POST https://api.smsactivate.uk/rent/order \
  -H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"service":"tg","country":2,"duration":24}'

Respuesta

{
  "message": "Number rented successfully.",
  "id": "ORDER_ID",
  "phone": "10000000000",
  "price": 2.50,
  "balance_remaining": 7.50
}

Errors

HTTP 400: solicitud no válida o saldo insuficiente. HTTP 409: no hay alquiler disponible. HTTP 503: el resultado está pendiente de revisión; no reintentes hasta que soporte revise el pedido.

POST/rent/cancel/{order_id}Solicita la cancelación de un alquiler elegible.

Se requiere clave de API.

Parámetros

order_id
Valor de ruta obligatorio. Sin cuerpo de solicitud.

Ejemplo de solicitud

curl -X POST https://api.smsactivate.uk/rent/cancel/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

Respuesta

Returns the cancellation result. Refunds may remain pending verification after cancellation is accepted.

Errors

La cancelación se limita a alquileres activos elegibles, entre 2 y 20 minutos después de la compra y antes de que llegue un SMS. HTTP 404: alquiler no encontrado. HTTP 409: el alquiler no es elegible. Si se acepta, su reembolso puede quedar pendiente de verificación.

GET/rent/extend/{order_id}/optionsConsulta las opciones de ampliación disponibles para un alquiler.

Se requiere clave de API.

Parámetros

order_id
Valor de ruta obligatorio del alquiler.

Ejemplo de solicitud

curl https://api.smsactivate.uk/rent/extend/ORDER_ID/options -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{
  "options": [{ "duration": 24, "price": 2.50 }],
  "expires_at": "2026-10-06T12:00:00Z"
}

Errors

HTTP 404: alquiler no encontrado. HTTP 409: el alquiler no es elegible (la ampliación se abre después de los primeros 20 minutos, el alquiler debe estar active o received, o hay una ampliación anterior pendiente de revisión). HTTP 503: la ampliación no está disponible temporalmente o no se pudieron cargar las opciones; inténtalo más tarde. Este endpoint tiene límite de solicitudes.

POST/rent/extend/{order_id}Amplía un alquiler activo.

Se requiere clave de API.

Parámetros

order_id
Valor de ruta obligatorio del alquiler.
duration
Obligatorio: 24, 72, 168, 336, 720, 1.440, 2.160 o 4.320 horas. Elige una de la respuesta actual de opciones.
expected_price
Número obligatorio copiado de la respuesta actual de opciones.
Idempotency-Key
Cabecera de solicitud UUID v4 obligatoria. Reutilízala solo para reintentar con seguridad el mismo intento de ampliación.

Ejemplo de solicitud

curl -X POST https://api.smsactivate.uk/rent/extend/ORDER_ID \
  -H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
  -H "Idempotency-Key: 3f6c1a52-8b1e-4c47-9d0a-6a1f2c9e7b10" \
  -d '{"duration":24,"expected_price":2.50}'

Respuesta

{
  "message": "Rental extended successfully.",
  "attempt_id": "REQUEST_UUID",
  "status": "settled",
  "charged": 2.50,
  "new_expires_at": "2026-10-10T12:00:00Z",
  "balance_remaining": 7.50
}

Errors

HTTP 422: falta o no es válido duration, expected_price o Idempotency-Key. HTTP 409: el alquiler no es elegible, la duración o el precio ya no se ofrecen, o la Idempotency-Key ya se usó. HTTP 202: la ampliación está pendiente de revisión; no reintentes con una nueva clave de idempotencia. HTTP 503: no se pudo confirmar la ampliación; contacta con soporte.

Verificación por correo

GET/emails/catalog?site={site}Lista los dominios de dirección de verificación disponibles para un sitio.

Se requiere clave de API.

Parámetros

site
Dominio del sitio web obligatorio, por ejemplo example.com.

Ejemplo de solicitud

curl 'https://api.smsactivate.uk/emails/catalog?site=example.com' -H "X-API-KEY: YOUR_API_KEY"

Respuesta

[{ "name": "sample-domain.test", "price": 0.10, "stock": 5 }]

Errors

HTTP 422: valor de site no válido. HTTP 503: catálogo de correo no disponible temporalmente.

POST/emails/buyCompra una dirección de verificación.

Se requiere clave de API.

Parámetros

site
Dominio del sitio web obligatorio.
domain
Dominio obligatorio elegido de la respuesta actual del catálogo.

Ejemplo de solicitud

curl -X POST https://api.smsactivate.uk/emails/buy \
  -H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"site":"example.com","domain":"sample-domain.test"}'

Respuesta

Returns an order object and balance_remaining when the purchase is confirmed.

Errors

HTTP 400: saldo del monedero insuficiente. HTTP 409: dominio sin stock. HTTP 503: la compra está pendiente de revisión; no reintentes hasta que soporte revise el pedido.

POST/emails/{order_id}/reorderPide la misma dirección de nuevo cuando el pedido anterior haya terminado.

Se requiere clave de API.

Parámetros

order_id
Valor de ruta obligatorio de un pedido de correo finalizado (numérico). Sin cuerpo de solicitud.

Ejemplo de solicitud

curl -X POST https://api.smsactivate.uk/emails/ORDER_ID/reorder -H "X-API-KEY: YOUR_API_KEY"

Respuesta

Returns the new email order, same shape as the email order response. The price is quoted at order time and charged from your balance.

Errors

HTTP 404: pedido no encontrado. HTTP 409: el pedido anterior no ha terminado, ya hay un nuevo pedido en curso o esta dirección no se puede volver a pedir ahora. HTTP 503: las verificaciones por correo no están disponibles temporalmente. Este endpoint tiene límite de solicitudes.

GET/emails/historyLista tus pedidos de verificación por correo.

Se requiere clave de API.

Parámetros

page
Número de página opcional; por defecto 1.
per_page
Tamaño de página opcional; por defecto 20 y con tope de 50.

Ejemplo de solicitud

curl 'https://api.smsactivate.uk/emails/history?page=1&per_page=20' -H "X-API-KEY: YOUR_API_KEY"

Respuesta

Returns paginated order data and page metadata.

Errors

Si la tabla de pedidos de correo no está disponible, la API devuelve un array data vacío.

GET/emails/status/{order_id}Consulta o actualiza un pedido de verificación.

Se requiere clave de API.

Parámetros

order_id
Valor de ruta obligatorio devuelto por la respuesta de compra.

Ejemplo de solicitud

curl https://api.smsactivate.uk/emails/status/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

Respuesta

Returns the order status and available verification result fields.

Errors

HTTP 404: pedido no encontrado. HTTP 503: no se pudo actualizar el estado. La respuesta solo incluye los campos disponibles para el pedido.

DELETE/emails/{order_id}Solicita la cancelación de un pedido de verificación por correo.

Se requiere clave de API.

Parámetros

order_id
Valor de ruta obligatorio devuelto por la respuesta de compra.

Ejemplo de solicitud

curl -X DELETE https://api.smsactivate.uk/emails/ORDER_ID -H "X-API-KEY: YOUR_API_KEY"

Respuesta

Returns the cancellation result. The refund can remain pending verification.

Errors

El pedido debe pertenecer a tu cuenta y ser elegible para cancelación; consulta el mensaje de error devuelto para ver el estado actual del pedido. Si la respuesta indica que la cancelación aún no se ha confirmado (HTTP 503), espera un par de minutos y envía la solicitud de nuevo.

Webhooks

GET/webhookConsulta la configuración de tu webhook.

Se requiere clave de API.

Parámetros

Ninguno
Sin parámetros de consulta.

Ejemplo de solicitud

curl https://api.smsactivate.uk/webhook -H "X-API-KEY: YOUR_API_KEY"

Respuesta

Returns the saved endpoint configuration. The signing secret is not returned by this read request.

Errors

Devuelve la configuración actual de la cuenta autenticada.

PUT/webhookCrea o actualiza la URL de tu webhook.

Se requiere clave de API.

Parámetros

url
URL HTTPS pública obligatoria en el puerto 443. Se rechazan las direcciones locales y privadas.

Ejemplo de solicitud

curl -X PUT https://api.smsactivate.uk/webhook \
  -H "X-API-KEY: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/hooks/sms"}'

Respuesta

Returns the saved configuration. On first setup the signing secret is returned once; store it safely.

Errors

HTTP 422: la URL no es una dirección HTTPS pública aceptada.

POST/webhook/rotate-secretSustituye el secreto de firma de tu webhook configurado.

Se requiere clave de API.

Parámetros

Ninguno
Sin cuerpo de solicitud. Configura primero un webhook.

Ejemplo de solicitud

curl -X POST https://api.smsactivate.uk/webhook/rotate-secret -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{ "secret": "NEW_SECRET_SHOWN_ONCE" }

Errors

HTTP 404: no hay webhook configurado. Guarda el nuevo secreto de forma segura; lo devuelve esta respuesta de rotación, no el endpoint de lectura.

DELETE/webhookElimina la configuración de tu webhook.

Se requiere clave de API.

Parámetros

Ninguno
Sin cuerpo de solicitud.

Ejemplo de solicitud

curl -X DELETE https://api.smsactivate.uk/webhook -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{ "configured": false }

Errors

Elimina la configuración del webhook de la cuenta autenticada.

POST/webhook/testEnvía un evento de prueba a tu endpoint configurado.

Se requiere clave de API.

Parámetros

Ninguno
Sin cuerpo de solicitud. Configura primero un webhook.

Ejemplo de solicitud

curl -X POST https://api.smsactivate.uk/webhook/test -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{
  "delivered": true,
  "http_status": 200,
  "message": "Your server accepted the test message."
}

Errors

HTTP 404: no hay webhook configurado. Una entrega de prueba informa delivered=false cuando tu servidor no la acepta.

GET/webhook/deliveriesRevisa hasta 50 intentos recientes de entrega de webhook.

Se requiere clave de API.

Parámetros

Ninguno
Sin parámetros de consulta.

Ejemplo de solicitud

curl https://api.smsactivate.uk/webhook/deliveries -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{
  "data": [{ "id": 42, "event_id": "EVENT_ID", "event_type": "sms.received", "status": "success", "attempts": 1, "http_status": 200 }]
}

Errors

Devuelve las 50 entregas HTTP de webhook más recientes, de la más nueva a la más antigua.

POST/webhook/deliveries/{id}/retryReintenta ahora una de tus entregas de webhook.

Se requiere clave de API.

Parámetros

id
Valor de ruta obligatorio del registro de entrega.

Ejemplo de solicitud

curl -X POST https://api.smsactivate.uk/webhook/deliveries/42/retry -H "X-API-KEY: YOUR_API_KEY"

Respuesta

{ "status": "success", "http_status": 200 }

Errors

HTTP 404: entrega no encontrada. Este endpoint tiene límite de solicitudes.

4. Facturación

Tu saldo se cobra al hacer un pedido. Las activaciones que no reciben ningún SMS dentro de la ventana de 20 minutos se reembolsan a tu saldo. Las reglas de cancelación y reembolso son distintas para alquileres, correos y API Links.

5. Cancelación y reembolsos

En los pedidos de números (activaciones) puedes solicitar la cancelación pasados los primeros 2 minutos y antes de que termine la ventana de activación de 20 minutos, solo mientras no haya llegado ningún SMS. Las cancelaciones elegibles y confirmadas devuelven el importe del pedido a tu saldo.

Una activación no se puede cancelar cuando ya ha llegado un SMS ni después de que termine su ventana. Si una activación elegible no recibe ningún SMS durante su ventana de 20 minutos, el importe del pedido se reembolsa a tu saldo.

Los alquileres se pueden cancelar en la misma ventana de 2 a 20 minutos mientras no haya llegado ningún código. El reembolso de un alquiler queda pendiente de verificación y no es automático.

Los números en bloque, los API Links y los pedidos de correo no son reembolsables una vez entregados, salvo que el panel indique lo contrario.

Si no se puede confirmar una cancelación, contacta con soporte antes de volver a intentarlo.

Frequently asked questions

How do I authenticate with the API?

Create or rotate a key in your dashboard. Send it in the X-API-KEY header with every request. The key is shown once when you create or rotate it. Keep it server-side. Open your dashboard.

What do I need for my first order?

A service code and a numeric country ID. Find them with GET /services and GET /countries/{service}, then check GET /offers/{service}/{country}. Prices are shown live in the dashboard. See live prices.

How do I read the code that arrives?

Poll GET /status/{order_id} and read sms_code when the status is received. GET /sms/{order_id} is rate-limited; do not use it for routine polling.

What if no SMS arrives?

An eligible activation with no SMS in its 20-minute window is refunded. You can also cancel an eligible active activation 2 to 20 minutes after purchase, before an SMS arrives. If a purchase response is uncertain, do not retry it; contact support. Read the FAQ.

Can I cancel an order?

For eligible active activations: POST /cancel/{order_id}, 2 to 20 minutes after purchase, before an SMS arrives. Rentals use POST /rent/cancel/{order_id}. API Links are final sale.

Does this API send verification codes to my users?

No. It receives codes on a number you order. If you need to send codes to your own users, this API is not the tool for that job.

How do webhooks work?

Set a public HTTPS URL on port 443 with PUT /webhook; the signing secret is returned once. Verify the signature as sha256= HMAC-SHA256 of "." and reject timestamps more than five minutes old. Test with POST /webhook/test.

¿Necesitas un límite mayor o una integración a medida? Contacta con nuestro equipo. o abre tu panel.