Verify phone
Confirms user phone number using a 6-digit SMS code. This step is required before any financial operation.
Flow
1. Request code
Call /request_confirmation/ with phone: true to send code by SMS.
2. Verify code
Send received code to /verify_phone/ with by_phone: true to confirm phone.
Profile field phone_verified is updated to true.
Step 1 - Request SMS verification code
Request verification code (phone)
Authorizations
Both
x-api-key and Authorization: Bearer <token> headers are required.Endpoint
POSThttps://dev.backend.colurs.co/request_confirmation/Required Headers
Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| phone | boolean | Must be true to send code by SMS | |
| boolean | Must be false when verifying phone |
cURL Example
curl -X POST https://dev.backend.colurs.co/request_confirmation/ \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json" \
-d '{"phone": true, "email": false}'Response
response.json
{
"message":
"Verification code sent"}⏱️
Code expires in 5 minutes. If it expires, request a new one.
Step 2 - Verify phone code
Verify phone
Authorizations
Both
x-api-key and Authorization: Bearer <token> headers are required.Endpoint
POSThttps://dev.backend.colurs.co/verify_phone/Required Headers
Content-Type: application/jsonAccept: application/jsonx-api-key: [API_KEY]Authorization: Bearer [ACCESS_TOKEN]Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| code | string | 6-digit code received by SMS | |
| by_phone | boolean | Must be true for phone verification |
cURL Example
curl -X POST https://dev.backend.colurs.co/verify_phone/ \
-H "Authorization: Bearer [ACCESS_TOKEN]" \
-H "x-api-key: [API_KEY]" \
-H "Content-Type: application/json" \
-d '{"code": "123456", "by_phone": true}'Response
response.json
Profile field phone_verified is updated to true on success.With email and phone verified, next step is KYC verification to operate on the platform.