ETERA API Documentation

curl -X POST https://api.etera.dev/auth/phone-number/verify \
     -H "Content-Type: application/json" \
     -d '{
  "phoneNumber": "589595029",
  "countryCode": "+971",
  "code": "123456"
}'

{
  "user": {
    "id": "user_123456",
    "email": "user@example.com",
    "phoneNumberVerified": true,
    "emailVerified": true,
    "createdAt": "2023-01-01T00:00:00.000Z",
    "updatedAt": "2023-01-01T12:00:00.000Z",
    "name": "John Doe",
    "firstName": "John",
    "lastName": "Doe",
    "image": "https://example.com/avatar.jpg",
    "phoneNumber": "+1234567890",
    "language": "en",
    "deviceTokens": [
      "fGzQ9k4FmkE:APA91bH...",
      "eXjP8l2AmcN:APA91bK..."
    ]
  },
  "session": {
    "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "expiresAt": "2023-01-08T00:00:00.000Z"
  },
  "isNewUser": true
}

Verifies the OTP sent to the phone number and completes authentication. Optionally sets user's preferred language.

Request

This endpoint expects an object.

phoneNumberstringRequired

Phone number without country code (e.g., 589595029)

countryCodestringRequired

Country calling code with + prefix (e.g., +971, +1, +44)

codestringRequired

The OTP code received via SMS

languagestringOptional

Optional: User’s preferred language (e.g., ‘en’, ‘ar’, ‘fr’)

Response

OTP verified successfully

userobject

sessionobject

isNewUserboolean

Whether this is a new user registration

Verify phone OTP

Request

Response

Errors