ETERA API Documentation

const url = 'https://api.etera.dev/auth/phone-number/verify';
const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: '{"phoneNumber":"589595029","countryCode":"+971","code":"123456"}'
};
try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

{
  "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

Errors

400

Bad Request Error