---
title: "List Notifications"
method: GET
path: "/api/v1/notifications"
tags: ["Notifications"]
---

# List Notifications

`GET /api/v1/notifications`

## Request

- Base URL: `https://api.flexiple.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.flexiple.com/api/v1/notifications`
- Auth: HTTP bearer

## Query parameters

- `unread` boolean

## Response `200`

Notifications list

- object
  - `data` Notification[], required
    - `id` integer, required
    - `notification_type` 'task_comment_added' | 'task_assigned' | 'task_status_changed' | 'task_due' | 'sourcing_proposal' | 'sourcing_blocked' | 'sourcing_waiting' | 'sourcing_expanded' | 'bulk_shortlist_finished' | 'agent_task_finished', required
    - `read_at` string, date-time, nullable, required
    - `created_at` string, date-time, required
    - `message` string, required
    - `is_read` boolean, required
    - `task` object, nullable, required
      - `id` integer, required
      - `task_type` string, nullable
      - `job_post` object, nullable
        - `id` integer, required
      - `job_application` object, nullable
        - `id` integer, required
    - `job_post_id` number, nullable, required
  - `meta` PaginationMeta, nullable
    - `total_count` integer
    - `total_pages` integer
    - `next_page` integer, nullable
    - `prev_page` integer, nullable
    - `current_page` integer
    - `page_size` integer

## Other responses

- `401`: Authentication failed

---

[API](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1.md) - [All operations](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/flexiple/apis/flexiple-platform-api-v1/revisions/27e7987859f2?raw)