---
title: "List emails received at the customer's invoice inbox"
method: GET
path: "/v1/web/bill/invoice-email"
tags: ["Bill"]
---

# List emails received at the customer's invoice inbox

`GET /v1/web/bill/invoice-email`

Audit log of emails forwarded to the customer's invoice address, newest first. Each email carries its attachments with per-attachment status and, for imported attachments, the `billId` of the draft bill it became.

## Query parameters

- `page` integer
- `pageSize` integer

## Response `200`

Default Response

- object
  - `items` object[], required
    - `id` string, required
    - `status` union, required
      - 'received'
      - 'rejected'
      - 'processed'
      - 'failed'
    - `sender` string
    - `receivedAt` string, date-time
    - `rejectReason` union
      - 'unknownSlug'
      - 'domainMismatch'
      - 'authFail'
      - 'spam'
      - 'volumeExceeded'
      - 'unknownSender'
      - 'noUsableAttachment'
    - `attachmentCount` number, required
    - `attachments` object[], required
      - `id` string, required
      - `fileName` string
      - `status` union, required
        - 'importing'
        - 'imported'
        - 'skipped'
        - 'failed'
        - 'duplicated'
        - 'released'
      - `skipReason` union
        - 'unsupported'
        - 'unreadable'
        - 'oversized'
      - `statusReason` union
        - 'duplicate'
        - 'billDeleted'
      - `billId` string
      - `duplicateOfBillId` string
      - `duplicateOfBillStatus` union
        - 'draft'
        - 'submitted'
        - 'returned'
        - 'paymentPending'
        - 'paymentInProgress'
        - 'paid'
        - 'paymentFailed'
        - 'manuallyCompleted'
        - 'deleted'
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
  - `hasNext` boolean, required
  - `totalCount` number, required

## Other responses

- `400` — Default Response
- `401` — The access to this resource has been denied
- `403` — The access to this resource is forbidden
- `default` — Catch-all error response for any unexpected internal errors

---

[API](https://skmtc.net/funneldash/apis/surface-web-api.md) · [All operations](https://skmtc.net/funneldash/apis/surface-web-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/funneldash/surface-web-api/versions/ac700d65f443/schema)