Get number

This request can change an order or incur charges. The examples do not retry it automatically. Reading a newly received SMS can trigger payment, even though the method uses GET.

AuthenticationCopy Anchor Link

ParametersCopy Anchor Link

No request body is required.

How to use this methodCopy Anchor Link

Request a number for your chosen country and service.

Choose codes from the reference lists. Check prices, number counts and message type settings before ordering. You can also compare operator prices and prices by country.

Save data.orderId for Receive SMS and other order requests. Use data.orderExpireIn to calculate the order deadline. If the request times out, check Current orders before requesting another number: the first order may already exist.

Request examplesCopy Anchor Link

Runtime requirements and environment setup. cURL uses a POSIX shell. JavaScript and TypeScript run in Node.js. Java uses the standard HTTP client and prints raw JSON; use your application’s JSON library to inspect the body.

: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
curl --fail-with-body --max-time 30 --request GET \
  --url "https://api.smspva.com/activation/number/BD/opt20?voice=0" \
  --header "apikey: $SMSPVA_API_KEY"

ResponsesCopy Anchor Link

The examples below show the response format. Prices, stock and account values are sample data; use the API response for current values.

{
  "statusCode": 200,
  "data": {
    "orderId": 123456,
    "phoneNumber": 9876544321,
    "countryCode": "BD",
    "orderExpireIn": 600
  }
}

{
  "statusCode": 405,
  "error": {
    "type": "INVALID_PARAMS",
    "description": "Invalid params."
  }
}

{
  "statusCode": 407,
  "error": {
    "type": "LOW_BALANCE",
    "description": "Low balance."
  }
}

{
  "statusCode": 411,
  "error": {
    "type": "ACCESS_LIMITED",
    "description": "Access is temporary limited."
  }
}

{
  "statusCode": 500,
  "error": {
    "type": "NUMBER_FETCH_FAIL",
    "description": "Failed to fetch number"
  }
}

{
  "statusCode": 501,
  "error": {
    "type": "PRICE_FETCH_FAIL",
    "description": "Failed to fetch price"
  }
}

{
  "statusCode": 502,
  "error": {
    "type": "NUMBER_NOT_FOUND",
    "description": "Number not found."
  }
}

{
  "statusCode": 503,
  "error": {
    "type": "SERVER_BUSY",
    "description": "Server overload, try later."
  }
}

Related guidesCopy Anchor Link

• Activation V2
• Reference data
• Activation workflow
• Errors and limits
• Download OpenAPI

If a connection fails during an order-changing request, check the order before trying again.