Skip to main content
POST
/
auth
/
login
/
phone
Login with phone
curl --request POST \
  --url https://staging.api.commercengine.io/api/v1/{store_id}/storefront/auth/login/phone \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "country_code": "+91",
  "phone": "<string>",
  "register_if_not_exists": true
}'
{
  "message": "<string>",
  "success": true,
  "content": {
    "otp_token": "<string>",
    "otp_action": "<string>"
  }
}

Authorizations

​
Authorization
string
header
required

Access token

Headers

​
x-debug-mode
boolean

This param is used to enable debug mode. If debug mode is enabled, the API will return OTP as well. This is only for development and testing purposes.

Body

application/json
​
phone
string
required

10 digit phone number without country code.

​
country_code
string
default:+91

Two-letter code begin with a plus sign prefix that identifies different countries. By default it will be +91 if not provided.

Allowed value: "+91"
​
register_if_not_exists
boolean

This is used to send OTP to unregistered phone. By default it sends OTP to registered phone only. To send OTP to unregistered phone it should be pass with true value like this, "register_if_not_exists": true

Response

OK

​
message
string
required

A descriptive message confirming the success or failure of the Login process.

​
success
boolean
required

Indicates whether the request was successful or failure (true for success, false for failure).

​
content
object
required

An object containing the response content.

⌘I