Data Catalogs
API Error Codes
| Code | Description |
|---|---|
| 14226 | Session creation request missing metadata object or fields are incomplete. |
| 20000 | Country code is invalid or has unknown format. |
| 20001 | Phone number is invalid or has unknown format. |
Verification Method Types
| Code | Description |
|---|---|
| 10 | Inverse OTP via SMS. |
| 11 | Inverse OTP via WhatsApp. |
| 20 | Traditional OTP via SMS. |
| 21 | Traditional OTP via WhatsApp. |
| 30 | Traditional OTP via Robocall. |
Attempt Statuses
| Code | Description |
|---|---|
| 0b00000000000000 | Waiting for verification. |
| 0b10000000000000 | Verification successful. |
| 0b01000000000001 | Destination mismatch. For Inverse OTP, means someone tried to tamper with the result. |
| 0b01000000000010 | Origin mismatch. For Inverse OTP, user sent the message from a different number. |
| 0b01000000000100 | Attempt status was invalided because the session closed. |
| 0b01000000001000 | Attempt expired. |
| 0b01000000010000 | Client was disabled due to pending payment or administrative reasons. |
| 0b01000000100000 | Potential tampering due to mismatching verification methods. |
| 0b01000001000000 | Too many Traditional OTP submissions. |
| 0b01000010000000 | User exceeded their Traditional OTP quota for the current method. |
| 0b01000100000000 | Attempt made invalid by user-triggered cancellation/request. |
tip
As you can see, Veriph.One uses binary flags to determine the status of each attempt. These statuses can overlap, and you could have cases where verification is successful, but later, someone tried to tamper with it. The statuses can update over time due to this reason. We recommend masking the status result using an AND operation if you want to check for a specific status.
Verification Data Enrichment Flags
| Code | Description |
|---|---|
| 0b000 | No enrichment. |
| 0b001 | Enrich phone number metadata when verification is successful. |
| 0b010 | Enrich IP address metadata including geolocalization and analysis. Only available to paid plans. |
tip
These are binary flags and are meant to overlap, if you don't want any enrichment to happen, send a plain zero in this field. If you want all data, send a 3. You can also select individual enrichment payloads by, for example, sending 1 or 2 according to your needs.