Notification History

Fetch the full notification history for the currently authenticated user. You must include a valid Bearer token — the response contains only notifications belonging to your account.

Request

GET /notifications/history

Authorization: Bearer <token>

Response

notifications

array

List of notification objects for the authenticated user.

Show Notification object

integer

Unique identifier for the notification.

userId

integer

ID of the user this notification belongs to.

rideId

integer

ID of the ride associated with this notification, if applicable.

title

string

Short heading for the notification (up to 120 characters).

message

string

Full notification body text (up to 800 characters).

channel

string

Delivery channel for the notification (e.g. in_app).

eventType

string

The event that triggered this notification (e.g. RIDE_STARTED, PAYMENT_RECEIVED).

read

boolean

true if you have already read this notification; false otherwise.

createdAt

string

ISO 8601 timestamp of when the notification was created.

deliveredAt

string

ISO 8601 timestamp of when the notification was delivered. May be null if not yet delivered.

status

string

Current delivery status of the notification (e.g. delivered, pending).

This endpoint returns notifications scoped to the authenticated user only. Tokens from other users cannot access your notification history.

Example

curl -X GET http://localhost:8080/notifications/history \
  -H "Authorization: Bearer <token>"

Session Status

Mark Read

⌘I

Request
Response
Example

Authentication

Rides

Payments

Notifications & Settings

Notification History

Request

Response

Example

Authentication

Rides

Payments

Notifications & Settings

​Request

​Response

​Example

Request

Response

Example