---
title: "List File Notes"
method: POST
path: "/v1/matters/{matter_id}/file-notes/search"
tags: ["file-notes"]
---

# List File Notes

`POST /v1/matters/{matter_id}/file-notes/search`

## Request

- Base URL: `https://api.ender.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ender.au/v1/matters/{matter_id}/file-notes/search`
- Auth: HTTP bearer

## Path parameters

- `matter_id` string, uuid, required

## Request body

- FileNoteListQuery
  - `query` string
  - `status` 'all' | 'draft' | 'signed'
  - `template_key` union
    - 'all'
    - 'capture' | 'solvency_analysis' | 'insolvent_trading' | 'ato_compliance_history' | 'director_asset_search' | 'books_and_records' | 'causes_of_failure' | 'voidable_summary'
  - `sort_order` 'updated_desc' | 'created_desc' | 'created_asc'
  - `limit` integer
  - `cursor` string, nullable

## Response `200`

Successful Response

- FileNoteList
  - `counts` FileNoteListCounts, required
    - `all` integer, required
    - `draft` integer, required
    - `signed` integer, required
  - `items` FileNoteListItem[], required
    - `id` string, uuid, required
    - `matter_id` string, uuid, required
    - `template_key` 'capture' | 'solvency_analysis' | 'insolvent_trading' | 'ato_compliance_history' | 'director_asset_search' | 'books_and_records' | 'causes_of_failure' | 'voidable_summary', required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `draft` FileNoteListVersionSummary, required
      - `id` string, uuid, required
      - `version_number` integer, required
      - `status` 'draft' | 'signed', required
      - `title` string, required
      - `updated_at` string, date-time, required
      - `signed_at` string, date-time, nullable, required
      - `source_count` integer, required
      - `document_ready` boolean, required
    - `signed` FileNoteListVersionSummary, required
      - `id` string, uuid, required
      - `version_number` integer, required
      - `status` 'draft' | 'signed', required
      - `title` string, required
      - `updated_at` string, date-time, required
      - `signed_at` string, date-time, nullable, required
      - `source_count` integer, required
      - `document_ready` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ender/apis/ender-backend.md) - [All operations](https://skmtc.dev/ender/apis/ender-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/ender/apis/ender-backend/revisions/a5849ac366ca?raw)