---
title: "GET /api/notification/admin"
method: GET
path: "/api/notification/admin"
tags: ["/api/notification/admin"]
---

# GET /api/notification/admin

`GET /api/notification/admin`

## Request

- Base URL: `` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/notification/admin`
- Auth: API key in header `X-API-Key`

List card-type notifications (alerts) for admin management. Supports pagination (`limit` +
  `offset` query params — handled by the offset-paging middleware), filtering, and sorting.

  `last_send_status` filter operates on the latest channel-send task_history row for the
  notification (`successful` = latest channel-send succeeded; `failing` = latest channel-send
  failed).

  `last_check_status` filter operates on the latest terminal TaskRun for the notification — the
  whole-run rollup (`successful` = the run succeeded; `failing` = it failed or was abandoned). This
  is a superset of `last_send_status`: it also catches query failures and heartbeat-abandoned runs
  that never reached the send step. The Failing tab uses `?last_check_status=failing`.

  `creatorless=true` selects notifications with no creator or a deactivated creator (the Ownerless
  tab). `creatorless=false` selects the inverse.

  `channel` accepts a single string or a repeated query param for multi-select (OR logic).

## Query parameters

- `recipient_email` string
- `query` string
- `creatorless` boolean, nullable: value must be a valid boolean string ('true' or 'false').
- `last_check_status` 'failing' | 'successful'
- `creator_active` boolean, nullable: value must be a valid boolean string ('true' or 'false').
- `card_id` integer
- `last_send_status` 'failing' | 'successful'
- `channel` union
  - string: value must be a non-blank string.
  - string[]
- `active` boolean, nullable: value must be a valid boolean string ('true' or 'false').
- `sort_column` 'id' | 'last_send' | 'last_check' | 'card_name' | 'creator_name' | 'updated_at'
- `creator_id` integer
- `sort_direction` 'asc' | 'desc'

## Response `2XX`

Successful response

- MetabaseNotificationApiAdminListResponse
  - `data` MetabaseNotificationApiAdminListRow[], required
    - `active` boolean, required
    - `created_at` string, date-time, required: value must be a valid date/time/datetime
    - `creator_id` integer, nullable, required: value must be an integer greater than zero.
    - `id` integer, required: value must be an integer greater than zero.
    - `last_check` MetabaseNotificationApiAdminRunSummary, required
      - `at` string, date-time, required: value must be a valid date/time/datetime
      - `error` string, nullable, required
      - `status` 'failing' | 'successful', required
    - `last_send` MetabaseNotificationApiAdminRunSummary, required
      - `at` string, date-time, required: value must be a valid date/time/datetime
      - `error` string, nullable, required
      - `status` 'failing' | 'successful', required
    - `payload_id` integer, nullable, required: value must be an integer greater than zero.
    - `payload_type` string, required
    - `updated_at` string, date-time, required: value must be a valid date/time/datetime
  - `limit` integer, nullable, required: value must be an integer greater than zero.
  - `offset` integer, nullable, required: value must be an integer greater or equal to than zero.
  - `total` integer, required: value must be an integer greater or equal to than zero.

## Other responses

- `4XX`: Client error response
- `5XX`: Server error response

## Changes

- **2026-11-04** `2e178f5a7934`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/metabase/apis/metabase-api/changes/api/notification/admin/get.md)

---

[API](https://skmtc.dev/metabase/apis/metabase-api.md) - [All operations](https://skmtc.dev/metabase/apis/metabase-api/llms.txt) - [OpenAPI document](https://skmtc.dev/metabase/apis/metabase-api/revisions/2e178f5a7934?raw)