Test numbers

There is no separate test key. To test your integration, add a number to the test list in the dashboard, in the Numbers section, and set a fixed code of 4–8 digits for it.

For a test number:

• no code is sent and nothing is charged;
• the fixed code you set is accepted;
• antifraud and limits do not apply, and the balance is not checked.

curl -X POST https://api.veryo.kz/v1/verify \
  -H "Authorization: Bearer $VERYO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone": "+77011234560"}'

{"id": "vrf_2b7d93e6f5a108c1f04a", "status": "pending", "expires_at": "2026-11-08T10:05:00Z", "test": true}

The check works as usual, through POST /v1/verify/check. The response will not have a channel field: the code was not sent anywhere.

Code expiry and the number of entry attempts work on test numbers the same way as on regular ones, so you can also test wrong-code and expired-code scenarios.

Other lists

List	Behavior
Test	The code is not sent, free of charge, the fixed code is accepted
Allowlist	No per-number limit and none of your account’s antifraud rules. The balance, the daily limit and the shared VERYO blocklist still apply
Blocklist	A code request gets 403 phone_blocked