@xfloor-memory-sdk
  1. Registration
@xfloor-memory-sdk
  • Get Started
    • Overview
    • Quick Start
    • Authentication and Identification
    • Core Concepts (5-Minute Read)
    • What to Use First (API Map)
  • SDK
    • Overview
    • SDK Installation & Setup
    • Python SDK
    • JavaScript SDK
    • Typescript SDK
    • Java SDK
    • FAQ & Troubleshooting
    • Copy-Paste Debug Checklists
  • Core FloorMemory
    • Query (Primary API)
      POST
    • Create Event (Post Content)
      POST
    • Recent Events
      GET
    • Basic information of a floor
      GET
  • Floor Management
    • Edit floor
    • Make floor Private
    • Make floor public
    • Rename floor
  • Registration
    • Sign Up
      POST
    • Sign In with email ID
      POST
    • Sign In with Mobile number
      POST
    • Validation
      POST
    • Change Password
      POST
    • Reset Password
      POST
    • Change email ID
      POST
    • Change Mobile number
      POST
    • Send Validation code
      POST
    • External User Registration
      POST
  • SDKs
  • Schemas
    • PostAdd
    • QueryResponse
    • Media
    • UserDetails
    • SignUpResponse
    • BlockDetails
    • FloorInfo
    • Threads
    • EventResponse
    • 400ErrorCode
    • Remaining
  1. Registration

Sign In with Mobile number

POST
/auth-service/sign/in/with/mobile/number
Authenticates a user using a registered mobile number.
The authentication method is determined by the specified mode.
When login_type is set to 1, the user is authenticated using the password associated with the account.
When login_type is set to 2, the user is authenticated using a one-time activation code (OTP) sent to the registered mobile number.
For OTP-based authentication (login_type = 1), the client must first call the Send Validation Code API with the appropriate login mode to generate and deliver the activation code.

Request Formdata#

FieldTypeRequiredDescription
mobile_numberstringYesMobile number
pass_codestringYesPassword/Validation code depending on the login_type
login_typestringYeslogin type 1 for password 2 for validation code
app_idstringYesApp ID
Field Description
mobile_number – Registered mobile number of the user
pass_code – Password / Validation code (password when login_type= 1; validation code when login_type = 2)
login_type – Login type
1 → Password-based login
2 → Activation code (OTP)–based login

Behavior Notes#

When login_type = 2, password validation is skipped.
OTP-based login requires a prior call to /auth-service/send/sign/in/validation/code.
Missing or invalid credentials for the selected mode will result in authentication failure.

Successful Response#

On successful authentication, the user is signed in and a success response is returned according to the authentication flow.

Error Response#

The API returns an error response if:
The mobile number is not registered
The password is incorrect (login_type = 1)
The activation code is missing, invalid, or expired (login_type = 2)
An invalid or unsupported mode is provided

One-Line Summary#

Signs in a user using a mobile number with either password-based or OTP-based authentication, based on the selected mode.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Body Params multipart/form-dataRequired

Responses

🟢200Success
application/json
Body

🟠400BadRequest
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://appfloor.in/auth-service/sign/in/with/mobile/number' \
--header 'Authorization: Bearer <token>' \
--form 'mobile_number=""' \
--form 'pass_code=""' \
--form 'login_type=""' \
--form 'app_id=""'
Response Response Example
200 - Example 1
{
    "error": {
        "code": "XF_VALIDATION_ERROR",
        "message": "Invalid mobile number",
        "path": "/auth-service/sign/in/with/mobile/number",
        "timestamp": "2026-01-12T08:11:59.993079561Z"
    }
}
Modified at 2026-02-27 11:46:18
Previous
Sign In with email ID
Next
Validation
Built with