Complete registration | Vlens

Finalize user registration after phone (and optionally email) verification. On success, returns an access token for the new user. Use this token in Authorization: Bearer <token> for all subsequent user-scoped requests.

Authentication

ApiKeystring

Static API key issued to your tenant. Obtain from the Vlens dashboard.

Request

This endpoint expects an object.

phoneNumberstringRequired

emailstring or nullOptionalformat: "email"

passwordstring or nullOptionalformat: "password"

phoneNumberOtpstring or nullOptional

phoneNumberOtpRequestIdstring or nullOptionalformat: "uuid"

geoLocationstring or nullOptional

Device location string at registration time.

imeistring or nullOptional

Device identifier (optional).

oAuthTokenVerificationRequestIdstring or nullOptionalformat: "uuid"

OAuth verification request ID from StepVerifyOAuthToken or VerifyOAuthToken. Providing this skips the email verification step.

Response

User registered successfully. Store the returned accessToken.

dataobject

error_codeinteger or null

error_messagestring or null

error_descriptionsany or null

$	curl -X POST https://api.vlenseg.com/api/DigitalIdentity/Register \
>	-H "ApiKey: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"phoneNumber": "+201234567890",
>	"email": "user@example.com",
>	"password": "SecurePass123!",
>	"phoneNumberOtp": "123456",
>	"phoneNumberOtpRequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
>	}'

1	{
2	"data": {
3	"isDigitalIdentityVerified": false,
4	"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
5	"expireInSeconds": 86400,
6	"user": {
7	"id": 42,
8	"emailAddress": "user@example.com",
9	"phoneNumber": "+201234567890"
10	}
11	},
12	"error_code": null
13	}

$	curl -X POST https://api.vlenseg.com/api/DigitalIdentity/Register \
>	-H "ApiKey: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"phoneNumber": "+201234567890",
>	"email": "user@example.com",
>	"password": "SecurePass123!",
>	"phoneNumberOtp": "123456",
>	"phoneNumberOtpRequestId": "3fa85f64-5717-4562-b3fc-2c963f66afa6"
>	}'

1	{
2	"data": {
3	"isDigitalIdentityVerified": false,
4	"accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
5	"expireInSeconds": 86400,
6	"user": {
7	"id": 42,
8	"emailAddress": "user@example.com",
9	"phoneNumber": "+201234567890"
10	}
11	},
12	"error_code": null
13	}