---
title: "List inbox notifications"
method: GET
path: "/notifications/inbox"
tags: ["notifications"]
---

# List inbox notifications

`GET /notifications/inbox`

## Request

- Base URL: `https://api.rhythms.ai`
- URL: `https://api.rhythms.ai/notifications/inbox`
- Auth: none required

Returns the current recipient's tenant-scoped inbox without marking notifications read.

This endpoint supports filtering and pagination through query parameters. Available ransackable attributes: uuid, notification_type, read_at, subject_type, created_at, sort_order.

## Query parameters

- `page` number
- `per_page` number
- `limit` number
- `limit_max` number
- `offset` number
- `count` string
- `q` object

## Other responses

- `400`: Bad Request - Invalid parameters or malformed request
- `401`: Unauthorized - Invalid or missing authentication
- `403`: Forbidden - User lacks permission to access this resource
- `404`: Not Found - Resource does not exist
- `422`: Unprocessable Entity - Invalid request parameters or validation errors
- `429`: Too Many Requests - Rate limit exceeded
- `500`: Internal Server Error - Unexpected server error

## Changes

- **2026-10-15** `7ed8cef9d8e9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/rhythms/apis/rhythms-params-in-body/changes/notifications/inbox/get.md)

---

[API](https://skmtc.dev/rhythms/apis/rhythms-params-in-body.md) - [All operations](https://skmtc.dev/rhythms/apis/rhythms-params-in-body/llms.txt) - [OpenAPI document](https://skmtc.dev/rhythms/apis/rhythms-params-in-body/revisions/3776068254ff?raw)