---
title: "List emails sent about your customers"
method: GET
path: "/outbox"
tags: ["Partners"]
---

# List emails sent about your customers

`GET /outbox`

## Request

- Base URL: `https://faivelo.com/api/partner`
- URL: `https://faivelo.com/api/partner/outbox`
- Auth: HTTP bearer

System emails Faivelo sent about your end customers (setup, credentials, recovery, notices), newest first. Requires `partner:read`.

## Query parameters

- `customer` string
- `category` string
- `status` 'sent' | 'sent_fallback' | 'failed'
- `since` string, date-time
- `limit` integer
- `cursor` string

## Response `200`

A page of emails

- object
  - `success` boolean
  - `data` object
    - `emails` PartnerOutboxEmail[]
      - `id` string
      - `createdAt` string, date-time
      - `customerId` string
      - `to` string
      - `from` string
      - `subject` string
      - `category` string, nullable
      - `sensitive` boolean: Credential or sign-in link mail; no body is stored
      - `status` 'sent' | 'sent_fallback' | 'failed'
      - `provider` string, nullable
      - `error` string, nullable
    - `nextCursor` string, nullable

## Other responses

- `401`: Missing or invalid API key, or not a partner key
- `403`: The key lacks the required scope, or provisioning is refused (partner paused, customer cap reached)
- `404`: Not found, including any customer that is not yours
- `429`: Rate limit exceeded

---

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