Register device

POST

/api/v1/auth/register-device

auth

Last modified:2026-06-04 22:55:16

Registers a guest user device for push notifications. Call this on first app launch before the user logs in. If the device is already registered, updates fcm_token and device_details. Location is extracted from Cloudflare headers automatically.

Success: 200 - device registered

Errors: 422 - missing required fields

Request

Body Params application/jsonRequired

Example

{
    "device_id": "device_a1b2c3d4e5",
    "device_name": "Samsung Galaxy S24",
    "fcm_token": "fcm_token_abc123xyz",
    "lat": 28.6139,
    "lng": 77.209,
    "opt_push_notification": true,
    "os_version": "Android 14"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/api/v1/auth/register-device' \
--header 'Content-Type: application/json' \
--data '{
    "device_id": "device_a1b2c3d4e5",
    "device_name": "Samsung Galaxy S24",
    "fcm_token": "fcm_token_abc123xyz",
    "lat": 28.6139,
    "lng": 77.209,
    "opt_push_notification": true,
    "os_version": "Android 14"
}'

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Device registered successfully"
}

🟠422Parameter Error

🟠429

Modified at 2026-06-04 22:55:16

Get audit logs

Send OTP