Login - Deriv Core API

This endpoint allows users to log in using either their email or phone number. Upon submitting the request, the system triggers an email or SMS containing a One-Time Password (OTP) that can be used to verify the user. Once verified, the server returns an access token for subsequent requests.

Request

Header Params

x-client-id

string

optional

Optional only required for internal systems referrence.

Default:

Body Params application/json

optional

One of

object

string

required

User's email address used for login.

phone

string

optional

User's phone number used for login, including country code.

Example

{
  "email": "mo***********@******.com"
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Success

application/json

Body

data

array [object {2}]

required

status

integer

optional

message

string

optional

meta

object

required

endpoint

string

required

method

string

required

timing

integer

required

Example

{
  "data": [
    {
      "status": 200,
      "message": "Please check your email or phone for the verification code."
    }
  ],
  "meta": {
    "endpoint": "/login",
    "method": "POST",
    "timing": 3170
  }
}

🟠400Missing Mandatory Param

🔴500Invalid req