# Developer docs

- [Welcome to SMSPVA](/en/docs): Your starting point for integrating the SMSPVA API.
- [Quickstart](/en/docs/quickstart): From API key to your first response, with no number purchase required.
- [Activation workflow](/en/docs/activation-workflow): Choose a number, retrieve its result, and manage the order.
- [Code examples](/en/docs/examples): Run direct HTTP examples in eight popular languages and tools.
- [SMS, caller-ID & voice](/en/docs/message-types): Understand the `voice` parameter, permission rules and result formats.
- [Countries & services](/en/docs/reference-data): Country and service codes for Activation V2.
- [Errors & limits](/en/docs/errors): Handle API errors, pending results and uncertain requests.
- Activation V2
  - [Activation V2](/en/docs/api): Complete reference for all 20 documented Activation V2 operations.

  - **Account**
  - [Get balance](/en/docs/api/balance): Read the current account balance.
  - [User information](/en/docs/api/userinfo): Read the account name, balance and karma.

  - **Reference data**
  - [Operators](/en/docs/api/operators): Find operator codes for a country, including donor operators.
  - [Conversion rates](/en/docs/api/conversions): Compare SMS reception quality indicators for a service across countries.
  - [Message type settings](/en/docs/api/country-service-settings): Check which message types are enabled for a country, service and operator.

  - **Availability**
  - [All number counts](/en/docs/api/countnumbers): Read available number counts grouped by country, operator and service.
  - [Country number counts](/en/docs/api/country-countnumbers): Check available numbers for one country.

  - **Prices**
  - [Service price](/en/docs/api/service-price): Read the price of one country and service, including operator prices.
  - [Country operator prices](/en/docs/api/country-operator-prices): Compare service and operator prices within a country.
  - [Service prices by country](/en/docs/api/service-prices): Compare service prices and availability across countries and operators.
  - [All service prices](/en/docs/api/all-service-prices): Read service prices across countries.

  - **Orders and results**
  - [Get number](/en/docs/api/get-number): Request an activation number for a country and service.
  - [Get number by operator](/en/docs/api/get-number-by-operator): Request an activation number from a selected operator.
  - [Receive SMS](/en/docs/api/receive-sms): Retrieve SMS, caller-ID or voice results; HTTP 202 means the result is pending.
  - [Current orders](/en/docs/api/orders): List current activation orders and their identifiers.
  - [Number status](/en/docs/api/number-status): Check a previously used number for the same service.

  - **Manage orders**
  - [Clear SMS](/en/docs/api/clear-sms): Clear the current SMS to receive another one.
  - [Stop SMS](/en/docs/api/stop-sms): Stop receiving SMS for an order.
  - [Cancel order](/en/docs/api/cancel-order): Cancel an activation order.
  - [Block number](/en/docs/api/block-number): Mark the number associated with an order as nonworking.
- Rental API
  - [Rental API](/en/docs/rental): All 22 documented rental methods, with HTTP examples in eight languages.
  - [Rental workflow](/en/docs/rental/workflow): Create, activate, read SMS, prolong and restore a rental.
  - [Countries & services](/en/docs/rental/reference-data): Currently enabled rental countries and services.
  - [Rental code examples](/en/docs/rental/examples): Run Rental API requests in eight languages with correct query authentication.
  - [Rental errors and responses](/en/docs/rental/errors): Check status and msg without changing the documented HTTP codes.

  - **Reference data**
  - [Rental countries](/en/docs/rental/countries): GET /api/rent.php?method=getcountries
  - [Default services](/en/docs/rental/default-services): GET /api/rent.php?method=get_default_services
  - [Countries by service](/en/docs/rental/countries-by-service): GET /api/rent.php?method=get_country_by_service

  - **Prices & availability**
  - [Rental data](/en/docs/rental/data): GET /api/rent.php?method=getdata
  - [Rental data by provider](/en/docs/rental/data-by-provider): GET /api/rent.php?method=getdataWithProviders
  - [Available number counts](/en/docs/rental/count): GET /api/rent.php?method=getcount
  - [Counts by provider](/en/docs/rental/counts-by-provider): GET /api/rent.php?method=getCountWithProviders
  - [Multi-service count](/en/docs/rental/multi-service-count): GET /api/rent.php?method=get_count_multi
  - [Canada PayPal days](/en/docs/rental/canada-paypal-days): GET /api/rent.php?method=get_days_canada_paypal
  - [Minimum PayPal days](/en/docs/rental/minimum-paypal-days): GET /api/rent.php?method=get_min_paypal_days

  - **Orders & SMS**
  - [Create rental](/en/docs/rental/create): GET /api/rent.php?method=create
  - [Create multi-service rental](/en/docs/rental/create-multi): GET /api/rent.php?method=create_multi
  - [Add service to order](/en/docs/rental/add-service): GET /api/rent.php?method=add_service_to_order
  - [Rental orders](/en/docs/rental/orders): GET /api/rent.php?method=orders
  - [Activate rental](/en/docs/rental/activate): GET /api/rent.php?method=activate
  - [Rental SMS](/en/docs/rental/sms): GET /api/rent.php?method=sms

  - **Manage rentals**
  - [Prolong rental](/en/docs/rental/prolong): GET /api/rent.php?method=prolong
  - [Prolong by days](/en/docs/rental/prolong-max): GET /api/rent.php?method=prolong_max
  - [Remove order](/en/docs/rental/delete): GET /api/rent.php?method=delete

  - **History & restoration**
  - [Rental history](/en/docs/rental/history): GET /api/rent.php?method=get_rent_history
  - [Restore precalculation](/en/docs/rental/restore-precalculation): GET /api/rent.php?method=restore_user_precalc
  - [Restore rental](/en/docs/rental/restore): GET /api/rent.php?method=restore_user
- Private Email Rental
  - [Private Email Rental API](/en/docs/email): All 14 email rental methods with eight-language examples and live lists.
  - [Email rental workflow](/en/docs/email/workflow)
  - [Providers & services](/en/docs/email/reference-data)
  - [Examples & setup](/en/docs/email/examples)
  - [Errors & response codes](/en/docs/email/errors)

  - **Reference data**
  - [Providers](/en/docs/email/providers): GET /api/rent_email.php?method=get_providers
  - [Services & prices](/en/docs/email/services): GET /api/rent_email.php?method=get_data
  - [Mailbox counts](/en/docs/email/counts): GET /api/rent_email.php?method=get_count

  - **Mailboxes & messages**
  - [Create rental](/en/docs/email/create): GET /api/rent_email.php?method=create_order
  - [Active orders](/en/docs/email/orders): GET /api/rent_email.php?method=get_orders
  - [List messages](/en/docs/email/messages): GET /api/rent_email.php?method=get_mails
  - [Message body](/en/docs/email/message-body): GET /api/rent_email.php?method=get_mail_body

  - **Manage rentals & aliases**
  - [Buy alias access](/en/docs/email/buy-alias): GET /api/rent_email.php?method=buy_alias
  - [Alias messages](/en/docs/email/alias-messages): GET /api/rent_email.php?method=get_mails_by_alias
  - [Extend rental](/en/docs/email/prolong): GET /api/rent_email.php?method=prolong_order
  - [Cancel rental](/en/docs/email/cancel): GET /api/rent_email.php?method=cancel_order

  - **Archive & restoration**
  - [Archived orders](/en/docs/email/archived): GET /api/rent_email.php?method=get_archived_orders
  - [Restoration cost](/en/docs/email/restoration-cost): GET /api/rent_email.php?method=calc_restore_order
  - [Restore rental](/en/docs/email/restore): GET /api/rent_email.php?method=restore_order
- [SDKs & libraries](/en/docs/sdks): Official SMSPVA SDKs for Python, JavaScript/TypeScript, PHP, Go, C#/.NET and Java.
- [MCP & AI tools](/en/docs/mcp): Connect your AI assistant to SMSPVA documentation for API search, complete pages and code examples in English, Spanish and Chinese.

# Documentación

- [Bienvenido a SMSPVA](/es/docs): Tu punto de partida para integrar la API de SMSPVA.
- [Inicio rápido](/es/docs/quickstart): De la clave API a tu primera respuesta, sin comprar un número.
- [Flujo de activación](/es/docs/activation-workflow): Elige un número, recupera el resultado y gestiona el pedido.
- [Ejemplos de código](/es/docs/examples): Solicitudes HTTP en ocho lenguajes y herramientas populares.
- [SMS, caller-ID y voz](/es/docs/message-types): Parámetro voice, permisos y formatos de resultado.
- [Países y servicios](/es/docs/reference-data): Códigos de país y servicio para Activation V2.
- [Errores y límites](/es/docs/errors): Gestiona errores, espera y solicitudes inciertas.
- Activation V2
  - [Activation V2](/es/docs/api): Referencia completa de los 20 métodos documentados de Activation V2.

  - **Cuenta**
  - [Consultar saldo](/es/docs/api/balance): Consulta el saldo actual de la cuenta.
  - [Información de usuario](/es/docs/api/userinfo): Consulta el nombre, el saldo y el karma de la cuenta.

  - **Datos de referencia**
  - [Operadores](/es/docs/api/operators): Obtén los códigos de operadores de un país, incluidos los operadores donantes.
  - [Tasas de conversión](/es/docs/api/conversions): Compara los indicadores de recepción SMS de un servicio por país.
  - [Configuración de mensajes](/es/docs/api/country-service-settings): Comprueba los tipos de mensaje permitidos por país, servicio y operador.

  - **Disponibilidad**
  - [Disponibilidad de todos los números](/es/docs/api/countnumbers): Consulta la disponibilidad por país, operador y servicio.
  - [Disponibilidad por país](/es/docs/api/country-countnumbers): Consulta los números disponibles en un país.

  - **Precios**
  - [Precio del servicio](/es/docs/api/service-price): Consulta el precio de un país y servicio, incluidos sus operadores.
  - [Precios por país y operador](/es/docs/api/country-operator-prices): Compara precios de servicios y operadores de un país.
  - [Precios del servicio por país](/es/docs/api/service-prices): Compara precios y disponibilidad por país y operador para un servicio.
  - [Todos los precios](/es/docs/api/all-service-prices): Consulta los precios de servicios por país.

  - **Pedidos y resultados**
  - [Obtener número](/es/docs/api/get-number): Solicita un número para un país y servicio.
  - [Obtener número por operador](/es/docs/api/get-number-by-operator): Solicita un número de un operador concreto.
  - [Recibir SMS](/es/docs/api/receive-sms): Recupera SMS, identificación de llamada o voz; HTTP 202 indica espera.
  - [Pedidos actuales](/es/docs/api/orders): Lista los pedidos actuales y sus identificadores.
  - [Estado del número](/es/docs/api/number-status): Comprueba un número utilizado anteriormente para el mismo servicio.

  - **Gestionar pedidos**
  - [Borrar SMS](/es/docs/api/clear-sms): Borra el SMS actual para recibir otro.
  - [Detener SMS](/es/docs/api/stop-sms): Detén la recepción SMS de un pedido.
  - [Cancelar pedido](/es/docs/api/cancel-order): Cancela un pedido de activación.
  - [Bloquear número](/es/docs/api/block-number): Marca como no operativo el número asociado a un pedido.
- Rental API
  - [Rental API](/es/docs/rental): Los 22 métodos documentados de alquiler con ejemplos en ocho lenguajes.
  - [Flujo de alquiler](/es/docs/rental/workflow): Crear, activar, leer SMS, ampliar y restaurar un alquiler.
  - [Países y servicios](/es/docs/rental/reference-data): Países y servicios de alquiler habilitados.
  - [Ejemplos de Rental](/es/docs/rental/examples): Ocho lenguajes con autenticación y parámetros query de alquiler.
  - [Errores de Rental](/es/docs/rental/errors): Interpreta status y msg conservando los códigos documentados.

  - **Datos de referencia**
  - [Países de alquiler](/es/docs/rental/countries): GET /api/rent.php?method=getcountries
  - [Servicios predeterminados](/es/docs/rental/default-services): GET /api/rent.php?method=get_default_services
  - [Países por servicio](/es/docs/rental/countries-by-service): GET /api/rent.php?method=get_country_by_service

  - **Precios y disponibilidad**
  - [Datos de alquiler](/es/docs/rental/data): GET /api/rent.php?method=getdata
  - [Datos por proveedor](/es/docs/rental/data-by-provider): GET /api/rent.php?method=getdataWithProviders
  - [Disponibilidad de números](/es/docs/rental/count): GET /api/rent.php?method=getcount
  - [Disponibilidad por proveedor](/es/docs/rental/counts-by-provider): GET /api/rent.php?method=getCountWithProviders
  - [Disponibilidad multiservicio](/es/docs/rental/multi-service-count): GET /api/rent.php?method=get_count_multi
  - [Días PayPal Canadá](/es/docs/rental/canada-paypal-days): GET /api/rent.php?method=get_days_canada_paypal
  - [Días mínimos PayPal](/es/docs/rental/minimum-paypal-days): GET /api/rent.php?method=get_min_paypal_days

  - **Pedidos y SMS**
  - [Crear alquiler](/es/docs/rental/create): GET /api/rent.php?method=create
  - [Crear alquiler multiservicio](/es/docs/rental/create-multi): GET /api/rent.php?method=create_multi
  - [Añadir servicio al pedido](/es/docs/rental/add-service): GET /api/rent.php?method=add_service_to_order
  - [Pedidos de alquiler](/es/docs/rental/orders): GET /api/rent.php?method=orders
  - [Activar alquiler](/es/docs/rental/activate): GET /api/rent.php?method=activate
  - [SMS del alquiler](/es/docs/rental/sms): GET /api/rent.php?method=sms

  - **Gestionar alquileres**
  - [Ampliar alquiler](/es/docs/rental/prolong): GET /api/rent.php?method=prolong
  - [Ampliar por días](/es/docs/rental/prolong-max): GET /api/rent.php?method=prolong_max
  - [Eliminar pedido](/es/docs/rental/delete): GET /api/rent.php?method=delete

  - **Historial y restauración**
  - [Historial de alquiler](/es/docs/rental/history): GET /api/rent.php?method=get_rent_history
  - [Cálculo de restauración](/es/docs/rental/restore-precalculation): GET /api/rent.php?method=restore_user_precalc
  - [Restaurar alquiler](/es/docs/rental/restore): GET /api/rent.php?method=restore_user
- Private Email Rental
  - [Private Email Rental API](/es/docs/email): Los 14 métodos de alquiler de email con ocho lenguajes y listas dinámicas.
  - [Flujo de alquiler de email](/es/docs/email/workflow)
  - [Proveedores y servicios](/es/docs/email/reference-data)
  - [Ejemplos y entorno](/es/docs/email/examples)
  - [Errores y códigos](/es/docs/email/errors)

  - **Datos de referencia**
  - [Proveedores](/es/docs/email/providers): GET /api/rent_email.php?method=get_providers
  - [Servicios y precios](/es/docs/email/services): GET /api/rent_email.php?method=get_data
  - [Disponibilidad de buzones](/es/docs/email/counts): GET /api/rent_email.php?method=get_count

  - **Buzones y mensajes**
  - [Crear alquiler](/es/docs/email/create): GET /api/rent_email.php?method=create_order
  - [Pedidos activos](/es/docs/email/orders): GET /api/rent_email.php?method=get_orders
  - [Listar mensajes](/es/docs/email/messages): GET /api/rent_email.php?method=get_mails
  - [Contenido del mensaje](/es/docs/email/message-body): GET /api/rent_email.php?method=get_mail_body

  - **Gestionar alquileres y alias**
  - [Comprar acceso a alias](/es/docs/email/buy-alias): GET /api/rent_email.php?method=buy_alias
  - [Mensajes del alias](/es/docs/email/alias-messages): GET /api/rent_email.php?method=get_mails_by_alias
  - [Ampliar alquiler](/es/docs/email/prolong): GET /api/rent_email.php?method=prolong_order
  - [Cancelar alquiler](/es/docs/email/cancel): GET /api/rent_email.php?method=cancel_order

  - **Archivo y restauración**
  - [Pedidos archivados](/es/docs/email/archived): GET /api/rent_email.php?method=get_archived_orders
  - [Coste de restauración](/es/docs/email/restoration-cost): GET /api/rent_email.php?method=calc_restore_order
  - [Restaurar alquiler](/es/docs/email/restore): GET /api/rent_email.php?method=restore_order
- [SDKs y bibliotecas](/es/docs/sdks): SDKs oficiales de SMSPVA para Python, JavaScript/TypeScript, PHP, Go, C#/.NET y Java.
- [MCP y herramientas de IA](/es/docs/mcp): Conecta tu asistente de IA a la documentación de SMSPVA para buscar métodos, leer páginas y obtener ejemplos en inglés, español y chino.

# 开发文档

- [欢迎使用 SMSPVA](/zh/docs): 从这里开始集成 SMSPVA API。
- [快速入门](/zh/docs/quickstart): 从 API 密钥到第一个响应，无需购买号码。
- [激活流程](/zh/docs/activation-workflow): 选择号码、获取结果并管理订单。
- [代码示例](/zh/docs/examples): 使用八种常用语言和工具发送直接 HTTP 请求。
- [短信、来电显示与语音](/zh/docs/message-types): 理解 voice 参数、权限规则和结果格式。
- [国家与服务](/zh/docs/reference-data): Activation V2 使用的国家及服务代码。
- [错误与限制](/zh/docs/errors): 处理 API 错误、等待响应及结果不明的请求。
- Activation V2
  - [Activation V2](/zh/docs/api): 已发布文档中全部 20 个 Activation V2 接口的完整参考。

  - **账户**
  - [查询余额](/zh/docs/api/balance): 读取当前账户余额。
  - [用户信息](/zh/docs/api/userinfo): 读取账户名称、余额及 karma。

  - **基础数据**
  - [运营商](/zh/docs/api/operators): 查询国家的运营商代码，包括外部供应商运营商。
  - [接收质量指标](/zh/docs/api/conversions): 比较同一服务在不同国家的短信接收质量指标。
  - [消息类型设置](/zh/docs/api/country-service-settings): 检查国家、服务和运营商组合允许的消息类型。

  - **余量**
  - [所有号码余量](/zh/docs/api/countnumbers): 按国家、运营商和服务读取号码余量。
  - [国家号码余量](/zh/docs/api/country-countnumbers): 查询指定国家的可用号码。

  - **价格**
  - [服务价格](/zh/docs/api/service-price): 读取一个国家和服务的价格及运营商价格。
  - [国家及运营商价格](/zh/docs/api/country-operator-prices): 比较一个国家内的服务及运营商价格。
  - [按国家查询服务价格](/zh/docs/api/service-prices): 比较同一服务在不同国家和运营商的价格及余量。
  - [所有服务价格](/zh/docs/api/all-service-prices): 读取各国家的服务价格。

  - **订单与结果**
  - [获取号码](/zh/docs/api/get-number): 为指定国家和服务申请激活号码。
  - [按运营商获取号码](/zh/docs/api/get-number-by-operator): 从指定运营商申请激活号码。
  - [接收短信](/zh/docs/api/receive-sms): 获取短信、来电显示或语音结果；HTTP 202 表示仍在等待。
  - [当前订单](/zh/docs/api/orders): 列出当前激活订单及其 ID。
  - [号码状态](/zh/docs/api/number-status): 检查此前在同一服务使用过的号码。

  - **管理订单**
  - [清除短信](/zh/docs/api/clear-sms): 清除当前短信，以接收下一条。
  - [停止接收短信](/zh/docs/api/stop-sms): 停止订单的短信接收。
  - [取消订单](/zh/docs/api/cancel-order): 取消激活订单。
  - [屏蔽号码](/zh/docs/api/block-number): 将订单对应的号码标记为不可用。
- Rental API
  - [Rental API](/zh/docs/rental): 全部 22 个租赁接口及八种语言 HTTP 示例。
  - [租赁流程](/zh/docs/rental/workflow): 创建、激活、读取短信、延期和恢复租赁。
  - [国家与服务](/zh/docs/rental/reference-data): 当前启用的租赁国家和服务。
  - [租赁代码示例](/zh/docs/rental/examples): 八种语言的查询参数及租赁身份验证示例。
  - [租赁错误与响应](/zh/docs/rental/errors): 保留原 HTTP 状态并正确处理 status 和 msg。

  - **基础数据**
  - [租赁国家](/zh/docs/rental/countries): GET /api/rent.php?method=getcountries
  - [默认服务](/zh/docs/rental/default-services): GET /api/rent.php?method=get_default_services
  - [按服务查询国家](/zh/docs/rental/countries-by-service): GET /api/rent.php?method=get_country_by_service

  - **价格与余量**
  - [租赁数据](/zh/docs/rental/data): GET /api/rent.php?method=getdata
  - [按供应商查询租赁数据](/zh/docs/rental/data-by-provider): GET /api/rent.php?method=getdataWithProviders
  - [可用号码数量](/zh/docs/rental/count): GET /api/rent.php?method=getcount
  - [按供应商查询余量](/zh/docs/rental/counts-by-provider): GET /api/rent.php?method=getCountWithProviders
  - [多服务余量](/zh/docs/rental/multi-service-count): GET /api/rent.php?method=get_count_multi
  - [加拿大 PayPal 天数](/zh/docs/rental/canada-paypal-days): GET /api/rent.php?method=get_days_canada_paypal
  - [PayPal 最短天数](/zh/docs/rental/minimum-paypal-days): GET /api/rent.php?method=get_min_paypal_days

  - **订单与短信**
  - [创建租赁](/zh/docs/rental/create): GET /api/rent.php?method=create
  - [创建多服务租赁](/zh/docs/rental/create-multi): GET /api/rent.php?method=create_multi
  - [向订单添加服务](/zh/docs/rental/add-service): GET /api/rent.php?method=add_service_to_order
  - [租赁订单](/zh/docs/rental/orders): GET /api/rent.php?method=orders
  - [激活租赁](/zh/docs/rental/activate): GET /api/rent.php?method=activate
  - [租赁短信](/zh/docs/rental/sms): GET /api/rent.php?method=sms

  - **管理租赁**
  - [延长租赁](/zh/docs/rental/prolong): GET /api/rent.php?method=prolong
  - [按天延长](/zh/docs/rental/prolong-max): GET /api/rent.php?method=prolong_max
  - [移除订单](/zh/docs/rental/delete): GET /api/rent.php?method=delete

  - **历史与恢复**
  - [租赁历史](/zh/docs/rental/history): GET /api/rent.php?method=get_rent_history
  - [恢复预估](/zh/docs/rental/restore-precalculation): GET /api/rent.php?method=restore_user_precalc
  - [恢复租赁](/zh/docs/rental/restore): GET /api/rent.php?method=restore_user
- Private Email Rental
  - [Private Email Rental API](/zh/docs/email): 全部 14 个邮箱租赁接口、八种语言示例及实时列表。
  - [邮箱租赁流程](/zh/docs/email/workflow)
  - [供应商与服务](/zh/docs/email/reference-data)
  - [示例与环境](/zh/docs/email/examples)
  - [错误与响应代码](/zh/docs/email/errors)

  - **基础数据**
  - [供应商](/zh/docs/email/providers): GET /api/rent_email.php?method=get_providers
  - [服务与价格](/zh/docs/email/services): GET /api/rent_email.php?method=get_data
  - [邮箱余量](/zh/docs/email/counts): GET /api/rent_email.php?method=get_count

  - **邮箱与邮件**
  - [创建租赁](/zh/docs/email/create): GET /api/rent_email.php?method=create_order
  - [有效订单](/zh/docs/email/orders): GET /api/rent_email.php?method=get_orders
  - [邮件列表](/zh/docs/email/messages): GET /api/rent_email.php?method=get_mails
  - [邮件正文](/zh/docs/email/message-body): GET /api/rent_email.php?method=get_mail_body

  - **管理租赁与别名**
  - [购买别名访问权](/zh/docs/email/buy-alias): GET /api/rent_email.php?method=buy_alias
  - [别名邮件](/zh/docs/email/alias-messages): GET /api/rent_email.php?method=get_mails_by_alias
  - [延长租赁](/zh/docs/email/prolong): GET /api/rent_email.php?method=prolong_order
  - [取消租赁](/zh/docs/email/cancel): GET /api/rent_email.php?method=cancel_order

  - **归档与恢复**
  - [归档订单](/zh/docs/email/archived): GET /api/rent_email.php?method=get_archived_orders
  - [恢复费用](/zh/docs/email/restoration-cost): GET /api/rent_email.php?method=calc_restore_order
  - [恢复租赁](/zh/docs/email/restore): GET /api/rent_email.php?method=restore_order
- [SDK 与库](/zh/docs/sdks): SMSPVA 官方 Python、JavaScript/TypeScript、PHP、Go、C#/.NET 和 Java SDK。
- [MCP 与 AI 工具](/zh/docs/mcp): 将 AI 助手连接到 SMSPVA 文档，搜索 API、阅读完整页面并获取英文、西班牙文和中文代码示例。