Number status

AuthenticationCopy Anchor Link

ParametersCopy Anchor Link

No request body is required.

How to use this methodCopy Anchor Link

Check whether a previously used number can still receive SMS for the same service. This check applies only if you have already received SMS on that number for that service. Send number without its country phone code.

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_NUMBER: number (required).

: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
: "${SMSPVA_NUMBER:?Set SMSPVA_NUMBER to your number}"
curl --fail-with-body --max-time 30 --request GET \
  --url "https://api.smspva.com/activation/numberstatus/${SMSPVA_NUMBER}/opt0" \
  --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": {
    "number": "98765432",
    "orderId": 123456,
    "countryCode": "+7"
  }
}

{
  "statusCode": 405,
  "error": {
    "type": "INVALID_NUMBER_FORMAT",
    "description": "Number should be integer with more than 5 digits"
  }
}

{
  "statusCode": 406,
  "error": {
    "type": "ORDER_NOT_FOUND",
    "description": "Order not found."
  }
}

{
  "statusCode": 500,
  "error": {
    "type": "SERVER_ERROR",
    "description": "An internal error has occurred while processing your request."
  }
}

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.