User Settings

Settings are per-user and tied to your authenticated account. All requests must include an Authorization header with a valid bearer token.

Authorization: Bearer <your_token>

Fetch your current settings

Retrieve your current settings before making changes so you can update only the fields you want to change.

GET /user-settings
Authorization: Bearer <your_token>

Example response

{
  "tripSharingDefault": true,
  "hidePhoneNumber": false,
  "emergencyContact": "+919876543210",
  "defaultPaymentMethod": "upi",
  "autoTipEnabled": false,
  "invoiceEmailEnabled": true,
  "mapStyle": "standard",
  "avoidTolls": false,
  "avoidHighways": false,
  "navigationVoiceLanguage": "en",
  "preferredVehicleType": "mini",
  "acPreference": "any",
  "quietRide": false,
  "deleteAccountRequested": false,
  "createdAt": "2026-01-15T08:00:00Z",
  "updatedAt": "2026-03-20T14:30:00Z"
}

Update your settings

Send a PUT /user-settings request with only the fields you want to change. All fields are optional — omit any field you want to leave unchanged.

PUT /user-settings
Authorization: Bearer <your_token>
Content-Type: application/json

{
  "defaultPaymentMethod": "card",
  "preferredVehicleType": "premium",
  "quietRide": true,
  "avoidTolls": true,
  "navigationVoiceLanguage": "hi"
}

Example response

{
  "tripSharingDefault": true,
  "hidePhoneNumber": false,
  "emergencyContact": "+919876543210",
  "defaultPaymentMethod": "card",
  "autoTipEnabled": false,
  "invoiceEmailEnabled": true,
  "mapStyle": "standard",
  "avoidTolls": true,
  "avoidHighways": false,
  "navigationVoiceLanguage": "hi",
  "preferredVehicleType": "premium",
  "acPreference": "any",
  "quietRide": true,
  "deleteAccountRequested": false,
  "updatedAt": "2026-04-02T11:05:00Z"
}

Settings reference

Field	Type	Default	Description
`tripSharingDefault`	boolean	`true`	Automatically share your live trip with trusted contacts when a ride starts
`hidePhoneNumber`	boolean	`false`	Hide your phone number from drivers
`emergencyContact`	string	`""`	Phone number to contact in an emergency
`defaultPaymentMethod`	string	`"upi"`	Payment method pre-selected at booking (e.g. `upi`, `cash`, `card`)
`autoTipEnabled`	boolean	`false`	Automatically add a tip when a ride is completed
`invoiceEmailEnabled`	boolean	`true`	Send a ride receipt to your email after each trip
`mapStyle`	string	`"standard"`	Map display style (e.g. `standard`, `satellite`)
`avoidTolls`	boolean	`false`	Prefer routes that avoid toll roads
`avoidHighways`	boolean	`false`	Prefer routes that avoid highways
`navigationVoiceLanguage`	string	`"en"`	Language code for in-app voice navigation (e.g. `en`, `hi`, `ta`)
`preferredVehicleType`	string	`"mini"`	Vehicle type pre-selected at booking (e.g. `mini`, `sedan`, `premium`)
`acPreference`	string	`"any"`	AC preference for rides — `any`, `ac`, or `non-ac`
`quietRide`	boolean	`false`	Signal to drivers that you prefer a quiet trip with minimal conversation
`deleteAccountRequested`	boolean	`false`	Flag a request to delete your account

Setting deleteAccountRequested to true flags your account for deletion. Contact support if you set this unintentionally.

Get Started

Core Concepts

Guides

Settings reference

​Settings reference

Settings reference