Viso.li

Verify Account

POSThttps://www.viso.li/api/account/verify

Checks the 6-digit code emailed by Create Account and marks the account verified. This call does not sign the user in and does not return an API key.

This endpoint does not use an API key. Requests are limited by client IP.

Request body

Send a JSON object.

Fields

FieldTypeDescription
emailstringRequired. Address used when the account was created.
codestringRequired. Six-digit code from the verification email.

Example request

This confirms the code emailed to ada@example.com.

1curl -X POST https://www.viso.li/api/account/verify \
2 -H "Content-Type: application/json" \
3 -d '{
4 "email": "ada@example.com",
5 "code": "123456"
6}'

Success response

Returns 200 OK. The code was accepted. This response does not include a session or an API key.

response.json
1{
2 "email": "ada@example.com",
3 "verified": true
4}

Response fields

FieldTypeDescription
emailstringRequired. Address that was verified.
verifiedbooleanRequired. The verification code was accepted.

Errors

StatusErrorDescription
400Bad RequestThe body is not JSON, the code is not 6 digits, or the code is invalid or expired.
429Too Many RequestsMore than 2 requests per minute or 10 requests per day from this IP. The response includes a Retry-After header.
500Internal Server ErrorUnexpected server error. Retry the request.