---
title: "List users with failing email"
method: GET
path: "/v1/email-health/failing"
tags: ["email-health"]
---

# List users with failing email

`GET /v1/email-health/failing`

## Request

- Base URL: `https://api.brixsignage.com`
- URL: `https://api.brixsignage.com/v1/email-health/failing`
- Auth: HTTP bearer

Returns the users in the workspace whose email address is currently bouncing or has been marked as spam, so an admin can see who Brix currently cannot reach by email.

**Notes.**
- Active people only, limited to the people the caller can see.

## Response `200`

Success.

- object
  - `data` object[], required
    - `id` string, required: User id.
    - `name` string, required
    - `email` string, required
    - `failingAt` string, required: When delivery started to fail.
    - `reason` string, nullable, required

## Other responses

- `401`: Missing, expired or revoked bearer token.
- `403`: The token lacks the permission this operation needs (see `x-brix-permission`).
- `5XX`: Server error. The body carries a `requestId` to quote to support.

---

[API](https://skmtc.dev/brixsignage/apis/brix-api.md) · [All operations](https://skmtc.dev/brixsignage/apis/brix-api/llms.txt) · [OpenAPI document](https://skmtc.dev/brixsignage/apis/brix-api/revisions/02fd3665dc7d?raw)
