Current orders
List current activation orders and their identifiers.
Authentication
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
apikey | header | string | Yes | Your API key |
Parameters
No path or query parameters. No request body.
How to use this method
Find your current activation orders. Use the returned orderId with Receive SMS and the other methods that manage a single order.
Request examples
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/orders" \
--header "apikey: $SMSPVA_API_KEY"Responses
The examples below show the response format. Prices, stock and account values are sample data; use the API response for current values.
| HTTP | Description |
|---|---|
| 200 | Successful operation |
| 501 | Server failed to process request. |
| 503 | The server is overloaded and experiencing performance issues. Please try later. |
HTTP 200
Successful operation
Illustrative response
{
"statusCode": 200,
"data": {
"orders": [
{
"orderId": 123456,
"phoneNumber": 987654321,
"countryCode": "+7",
"orderExpireIn": 599,
"service": "opt0",
"country": "UK",
"status": "PENDING_SMS|SMS_READY|PENDING_PAYMENT",
"sms": {
"code": "1234",
"fullText": "Your service Activation code is 1234. Don't tell it anybody"
}
}
]
}
}Response fields
| Name | Type | Description |
|---|---|---|
statusCode | integer | Result status code |
data | object | Response data |
data.orders | array<object> | Response data |
data.orders[].orderId | integer | Order ID |
data.orders[].phoneNumber | integer | Phone number without country code |
data.orders[].countryCode | string | Country phone number code. |
data.orders[].orderExpireIn | integer | Order expiration time in seconds |
data.orders[].service | string | Service code Services list |
data.orders[].country | string | Country code according ITU-T E.123 & E.164 Countries list |
data.orders[].status | string | SMS status. |
data.orders[].sms | object | SMS status. |
data.orders[].sms.code | string | Service activation code from SMS. |
data.orders[].sms.fullText | string | Full SMS text. |
HTTP 501
Server failed to process request.
Illustrative response
{
"statusCode": 501,
"error": {
"type": "SERVER_FAIL",
"description": "Server failed to process request"
}
}Response fields
| Name | Type | Description |
|---|---|---|
statusCode | integer | Result status code |
error | object | Response data |
error.type | string | Error type |
error.description | string | Error description |
HTTP 503
The server is overloaded and experiencing performance issues. Please try later.
Illustrative response
{
"statusCode": 503,
"error": {
"type": "SERVER_BUSY",
"description": "Server overload, try later."
}
}Response fields
| Name | Type | Description |
|---|---|---|
statusCode | integer | Result status code |
error | object | Response data |
error.type | string | Error type |
error.description | string | Error description |
Related guides
If a connection fails during an order-changing request, check the order before trying again.