---
title: "Get notifications for company"
method: GET
path: "/v1/companies/{company_uuid}/notifications"
tags: ["Notifications"]
---

# Get notifications for company

`GET /v1/companies/{company_uuid}/notifications`

Returns all notifications relevant for the given company.

scope: `notifications:read`

## Path parameters

- `company_uuid` string, required

## Query parameters

- `status` 'open' | 'expired' | 'resolved'
- `page` integer
- `per` integer

## Headers

- `X-Gusto-API-Version` '2026-06-15'

## Response `200`

successful

- Notification[]
  - `uuid` string, required — Unique identifier of a notification.
  - `company_uuid` string, required — Unique identifier of the company to which the notification belongs.
  - `title` string, required — The title of the notification. This highlights the actionable component of the notification.
  - `message` string, required — The message of the notification. This provides additional context for the user and recommends a specific action to resolve the notification.
  - `status` 'open' | 'resolved' | 'expired', required — Represents the notification's status as managed by our system. It is updated based on observable system events and internal business logic, and does not reflect resolution steps taken outside our system. This field is read-only and cannot be modified via the API.
  - `category` string, required — The notification's category.
  - `actionable` boolean, required — Indicates whether a notification requires action or not. If false, the notification provides critical information only.
  - `can_block_payroll` boolean, required — Indicates whether a notification may block ability to run payroll. If true, we suggest that these notifications are prioritized to your end users.
  - `published_at` string, required — Timestamp of when the notification was published.
  - `due_at` string, nullable, required — Timestamp of when the notification is due. If the notification has no due date, this field will be null.
  - `template_variables` object — An object containing template variables used to render the notification. The structure of this object depends on the notification category. Each category defines a fixed set of variable names (keys), which are always present. The values of these variables can vary depending on the specific notification instance.
  - `resources` object[], required — An array of entities relevant to the notification
    - `entity_type` 'BankAccount' | 'Contractor' | 'ContractorPayment' | 'Employee' | 'Payroll' | 'PaySchedule' | 'RecoveryCase' | 'Signatory' | 'Wire In Request', required — The type of entity being described.
    - `entity_uuid` string, required — Unique identifier of the entity
    - `reference_type` string — Optional. The type of a resource that is related to the one described by entity_type and entity_uuid. For instance, if the entity_type is “BankAccount”, the reference_type could be the “Employee” or “Contractor” to whom the bank account belongs.
    - `reference_uuid` string — Optional. Unique identifier of the reference.

---

[API](https://skmtc.net/gusto/apis/gusto-api.md) · [All operations](https://skmtc.net/gusto/apis/gusto-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gusto/gusto-api/revisions/826dfa57fb3b/schema)