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

array

List of notification objects for the authenticated user.

Show Notification object

integer

Unique identifier for the notification.

integer

ID of the user this notification belongs to.

integer

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

string

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

string

Full notification body text (up to 800 characters).

string

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

string

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

boolean

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

string

ISO 8601 timestamp of when the notification was created.

string

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

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>"

{
  "notifications": [
    {
      "id": 42,
      "userId": 7,
      "rideId": 101,
      "title": "Your driver is arriving",
      "message": "Rahul (KA 05 AB 1234) is 2 minutes away.",
      "channel": "in_app",
      "eventType": "DRIVER_ARRIVING",
      "read": false,
      "createdAt": "2026-04-02T10:15:30Z",
      "deliveredAt": "2026-04-02T10:15:31Z",
      "status": "delivered"
    }
  ]
}

Authentication

Rides

Payments

Notifications & Settings

Notification History

Request

Response

Example

​Request

​Response

​Example

Request

Response

Example