---
title: "List a matter's documents"
method: GET
path: "/matters/{id}/documents"
tags: ["Documents"]
---

# List a matter's documents

`GET /matters/{id}/documents`

## Request

- Base URL: `https://api.suprememind.ai/v1`
- URL: `https://api.suprememind.ai/v1/matters/{id}/documents`
- Auth: HTTP bearer

Requires the `read` scope. Metadata only: the stored file's location is never
returned. Documents designated `aeo` (attorneys' eyes only) are not listed to a
key, because a key is not a named recipient; they are available in the app to
the people named on the matter.

## Response `200`

The documents.

- object
  - `object` 'list', required
  - `data` Document[], required
    - `id` integer, required
    - `object` 'document', required
    - `matter_id` string, required
    - `filename` string, required
    - `content_type` string, nullable
    - `size_bytes` integer, nullable
    - `designation` 'public' | 'confidential' | 'aeo', required
    - `include_in_analysis` boolean
    - `created_at` string, date-time, required
  - `has_more` boolean, required

## Other responses

- `401`: Missing, malformed, unknown or revoked key.
- `403`: The key lacks the scope, the address is not on its allowlist, or API access is off for the account.
- `404`: Nothing with that id is visible to this key.
- `429`: Too many requests, or too many jobs in flight.

---

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