---
title: "Get a notification's details"
method: GET
path: "/v1/notifications/{notification_uuid}"
tags: ["Notifications"]
---

# Get a notification's details

`GET /v1/notifications/{notification_uuid}`

Upon receiving a notification webhook event, use this endpoint to fetch the notification's details. The notification details include basic suggested content that can help you build notifications in your platform.

Note: partners are responsible for the delivery and any custom state management of notifications in their application. Refer to our [partner notification guide](https://docs.gusto.com/embedded-payroll/docs/partner-notifications) for more details.

If the notification UUID is not found, the response will be 404 Not Found. If the notification's supporting data is no longer valid, the response will be 422 Unprocessable Entity.

scope: `notifications:read`

## Path parameters

- `notification_uuid` string, required

## 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.

## Other responses

- `404` — Not Found The requested resource does not exist. Make sure the provided UUID is valid.
- `422` — Unprocessable Entity This may happen when the body of your request contains errors such as `invalid_attribute_value`, or the request fails due to an `invalid_operation`. See the [Errors Categories](https://docs.gusto.com/embedded-payroll/docs/error-categories) guide for more details.

---

[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)