single-service activations

Change the operation status

GEThttps://onlinesim.io/stubs/handler_api.php?action=setStatus

  • status=1 — only answers ACCESS_READY (after a key check); the operation does not change.
  • status=3 — moves to the next SMS: getStatus / getFullSms then show it (ACCESS_RETRY_GET).
  • status=6 — closes the operation (ACCESS_ACTIVATION). An operation without SMS can be closed only 120 seconds after the start (300 seconds for WhatsApp).

Other status values (8 included) give BAD_STATUS. Errors:

  • BAD_STATUS — unsupported status, or id is missing
  • NO_ACTIVATION — no operation with this id on your account
  • EARLY_CANCEL_DENIED — too early to close an operation without SMS
  • BAD_ACTION — e.g. the same id was closed less than 5 seconds ago
  • and the common errors

Security

Parameters

query3
NameTypeDescription
action*string

Method name: setStatus

Enum:setStatus
id*integer
≥ 1

Operation ID from getNumber

Example:65904893
status*integer

New status: 1, 3 or 6

Enum:136Example:6

Responses

200Result or an error
Content-Typetext/plain
Schema
schemaoneOf
One Of
[0]string
Enum:ACCESS_READYACCESS_RETRY_GETACCESS_ACTIVATION
[1]string
Enum:BAD_STATUSNO_ACTIVATIONEARLY_CANCEL_DENIED
[2]string
Error answered as text by every action (also by the JSON ones):
  • BAD_KEY — the API key is wrong or missing
  • BANNED — the account is blocked
  • BAD_ACTION — unknown action or an error without its own code (for example a temporary error or too many concurrent requests); check the request and repeat it later
  • Too many requests. Please wait a moment before trying again. — the converter's limit of getNumber, getRentNumber, setStatus and setRentStatus (3 requests per second, 150 per 30 seconds)
Enum:BAD_KEYBANNEDBAD_ACTIONToo many requests. Please wait a moment before trying again.

Examples

closed

Operation closed

ACCESS_ACTIVATION
next

Next SMS selected

ACCESS_RETRY_GET
early

Too early to close

EARLY_CANCEL_DENIED

Code Samples

Generating examples...