---
title: "List all inbox items"
method: GET
path: "/inbox"
tags: ["Inbox"]
---

# List all inbox items

`GET /inbox`

Retrieve a list of inbox items for the authenticated team.

## Query parameters

- `cursor` string, nullable — Pagination cursor from previous response
- `order` string, nullable — Sort direction: asc or desc
- `sort` string, nullable — Sort field. Valid values: alphabetical, document_date. Defaults to created date.
- `pageSize` number — Number of items per page (1-100)
- `q` string, nullable — Search query to filter inbox items
- `status` 'done' | 'pending' | 'suggested_match' | 'no_match' | 'other' | 'null', nullable — Filter by processing status: done (processed), pending (awaiting action), suggested_match (auto-matched), no_match (unmatched), other
- `tab` 'all' | 'other' | 'null', nullable — Tab filter: all or other

## Response `200`

Retrieve a list of inbox items for the authenticated team.

- object
  - `meta` object, required — Pagination metadata for the inbox list response.
    - `cursor` string, nullable — A cursor for pagination, representing the last item from the previous page.
    - `hasPreviousPage` boolean, required — Whether there is a previous page of results.
    - `hasNextPage` boolean, required — Whether there is a next page of results.
  - `data` object[], required — List of inbox items
    - `id` string, required — Inbox item ID (UUID)
    - `fileName` string, required — Original file name of the uploaded document
    - `filePath` string[], required — Path segments to the file in storage
    - `displayName` string, required — Display name for the inbox item
    - `amount` number, nullable, required — Amount detected or entered for the inbox item
    - `currency` string, nullable, required — Currency code (ISO 4217) for the amount
    - `contentType` string, nullable, required — MIME type of the uploaded file
    - `date` string, nullable, required — Date associated with the inbox item (ISO 8601)
    - `status` string, required — Status of the inbox item
    - `createdAt` string, required — Date and time when the inbox item was created (ISO 8601)
    - `website` string, nullable, required — Website associated with the inbox item, if any
    - `description` string, nullable, required — Description or notes for the inbox item
    - `transaction` object, nullable, required — Matched transaction for this inbox item, if any
      - `id` string, required — Transaction ID (UUID)
      - `amount` number, required — Transaction amount
      - `currency` string, required — Transaction currency (ISO 4217)
      - `name` string, required — Transaction name or payee
      - `date` string, required — Transaction date (ISO 8601)

## Other responses

- `default` — An error occurred

---

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