Register device

POST

https://uat-api.hastaai.in/api/v1/auth/register-device

auth

Last modified:2026-08-24 17:24:14

Registers a guest user device for push notifications. Call this on first app launch before the user logs in. Always creates a fresh guest registration for this device_id; if one already existed (e.g. reused/shared device) it is retired, not reused - so one guest's data can never carry over to a different guest on the same device. 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 'https://uat-api.hastaai.in/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-08-24 17:24:14

Get audit logs

Send OTP