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_here2. URL base
Todas las solicitudes a la API usan esta URL base:
https://api.smsactivate.ukEjemplo 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.
163COMwp- 11688
hn - 11and1
ahs - 11xbet
wj - 224betting
lh - 22dehands
apd - 22domains
erc - 22ememain
blx - 22ГИС
bcg - 332Red
qi - 3360Kredi
ayo - 33Fun
auw - 44FunLite
hk - 5500px
fpx - 551exch
boc - 551exchange
exc - 77-Eleven
aws - 8888casino
ll - 9999 Md
brv
99acresfw
99appki- 999Game
qkb - 999k Outlet
amq - AA23
acv - AA9A
gn - AAadhar
hra
Abastece-aíanb- AAbbott
ags
Ace2Threerh- AAcima
cim - AAcko
amf
AdaKamiko- AAdaModal
bdo - AAdani
bq - AAdidas
an - AAditya Birla
qff - AAdmiralBet
bst - AAdobe
byh
Advertsagw- AAEG Presents
rsn - AAffirm
bow - AAfreecaTV
aip
AGIBANKsa- AAgoda
ag
AgriDevelopcs- AAgroinform
qu - AAhlan
bsm - AAiqfome
bbi - AAir Miles
bsy - AAirba Fresh
bnp
Airbnbuk- AAirtasker
byd
Airtelzl- AAirtime
acy
AISwv- AAIS PLAY
axs
Aitujj
Akudorf
Akulakutm
Alchemyaav
Alfabt
Alfagiftbn- AAlfamidi
bgt - AAlFursan
bxr - AAlgida
lp - AAlibaba
ab
AliExpresshx- AAlignable
aul
Alipay/Alibaba/1688hw
All Accessajy
Allegroyn
AlloBanknh- AAllofresh
aeo - AAltyn-i
al - AAmap 高德地图
btx - AAmarthaFin
bsv
Amasiayo- AAmaze Super App
bzk
Amazonam- AAme Digital
afi - AAmway
aee - AAngel One
aha
Ankamaalg- AAnnoncelight
byw
Any Otherot
AOLpm
ApostaGanhaml
Applewx
Apteka Aprelaeh
AptekaRUgk- AAptekiPlus
rq - AAR Lens
aco
ArenaPlusabt- AArgent
amo - AAri10
blq - AASAAS
bqr - AAsda
hs - AAsiaMiles
ajp - AAsianDating
ayb - AAskable
bpi - AAspiration
aptn
Astra Otoshopafd
AstraPayaem
Astropaygr- AASVLA
buj - AAti Su
bhl - AAtlas Earth
awq - AAtlasbus
atb
AttaPollanl- AAUBANK
du
Auchanst- AAudible
aud - AAukro
aox - AAuthentify
ccy - AAuthor24
kd - AAutodesk
bbl
Autoruaej- AAv100pro
ajl - AAvito
av
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.
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/servicesRespuesta
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/tgRespuesta
{ "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/deliveryRespuesta
{
"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/links/optionsLista los servicios y países del catálogo de API Links.
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/links/optionsRespuesta
{
"services": [{
"id": "sample_service",
"name": "Sample service",
"countries": [{ "id": 2, "name": "United States", "price": 0.25, "stock": 4 }]
}],
"countries": [{ "id": 2, "name": "United States" }]
}Errors
Esta lista es solo para API Links. No es una lista general de países para pedidos de activación estándar.
GET/links/offers/{service}/{country}Consulta los precios y el stock actuales de inventario de API Links.
Público: no requiere clave de API.
Parámetros
- service
- Código de servicio del catálogo de opciones de API Links.
- country
- ID numérico de país de la lista de países de API Links del servicio seleccionado.
Ejemplo de solicitud
curl https://api.smsactivate.uk/links/offers/tg/1Respuesta
[{ "name": "any", "offers": [{ "price": "0.2500", "count": 4 }] }]Errors
Las selecciones no disponibles devuelven una lista vacía. Para comprar este producto, envía product=api_links a /get_numbers. Los API Links son venta final; quantity es 1 por defecto y debe estar entre 1 y 100.
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/2Respuesta
[
{
"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 "
¿Necesitas un límite mayor o una integración a medida? Contacta con nuestro equipo. o abre tu panel.
