Add your Key ID and Secret to send test requests.
List activations
Returns your activations, newest first, optionally filtered by status.
Authorization
KeyId ApiSecret x-key-id<token>
Your API key id.
In: header
x-api-secret<token>
Your API key secret.
In: header
Query Parameters
status?string
Value in
"waiting" | "activating" | "received" | "completed" | "expired" | "cancelled" | "refunded" | "unknown"page?integer
Default
1Range
1 <= value <= 10000pageSize?integer
Default
50Range
1 <= value <= 200Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/otp/activations?status=waiting&page=1&pageSize=50" \ -H "x-key-id: YOUR_KEY_ID" \ -H "x-api-secret: YOUR_API_SECRET"{
"data": [
{
"activationId": "ord_EXAMPLE_activation_000000000000000001",
"status": "cancelled",
"actions": {
"canResend": false,
"canReactivate": true
},
"serviceId": "BRAVO-US-gmx",
"service": "GMX",
"countryCode": "US_1",
"phoneNumber": "+12025550143",
"price": {
"amount": 0.508725,
"currency": "EUR"
},
"expiresAt": "2026-09-15T13:16:46.000Z",
"createdAt": "2026-09-15T12:56:46.923Z",
"updatedAt": "2026-09-15T23:19:08.044Z",
"resend": {
"price": {
"amount": 0.508725,
"currency": "EUR"
}
}
},
{
"activationId": "ord_EXAMPLE_activation_000000000000000002",
"status": "cancelled",
"actions": {
"canResend": false,
"canReactivate": true
},
"serviceId": "BRAVO-US-instagram_/_threads",
"service": "Instagram / Threads",
"countryCode": "US_1",
"phoneNumber": "+12025550187",
"price": {
"amount": 27.574627,
"currency": "EUR"
},
"expiresAt": "2026-09-11T16:01:10.000Z",
"createdAt": "2026-09-11T15:41:10.106Z",
"updatedAt": "2026-09-11T16:01:18.107Z",
"resend": {
"price": {
"amount": 27.574627,
"currency": "EUR"
}
}
}
],
"meta": {
"page": 1,
"pageSize": 2,
"total": 47,
"totalPages": 24,
"hasNext": true
}
}{
"error": {
"code": "VALIDATION_ERROR",
"message": "The request is not valid. See `fields` for what to correct.",
"requestId": "9f1c7b2e-…"
}
}{
"error": {
"code": "AUTHENTICATION_REQUIRED",
"message": "This endpoint requires an API key.",
"requestId": "9f1c7b2e-…"
}
}{
"error": {
"code": "CONFLICT",
"message": "The resource is not in a state that allows this operation.",
"requestId": "9f1c7b2e-…"
}
}{
"error": {
"code": "RATE_LIMITED",
"message": "Too many requests. Retry after the interval in `Retry-After`.",
"requestId": "9f1c7b2e-…"
}
}{
"error": {
"code": "INTERNAL_ERROR",
"message": "Something went wrong on our side.",
"requestId": "9f1c7b2e-…"
}
}{
"error": {
"code": "SERVICE_RESPONSE_INVALID",
"message": "The upstream service returned an unexpected response.",
"requestId": "9f1c7b2e-…"
}
}{
"error": {
"code": "SERVICE_UNAVAILABLE",
"message": "The service is temporarily unavailable. Try again shortly.",
"requestId": "9f1c7b2e-…"
}
}Overview
Previous Page
Receive SMS POST
Rents a number for a service and country, and starts waiting for its code. The rental is charged on success and the activation begins in `waiting`. `serviceId` identifies the offer to rent and comes from [GET /v1/otp/services](/openapi/otp/catalog/listOtpServices). It is opaque: send it back as published.