---
title: "List Proposals"
method: GET
path: "/api/internal/proposals"
tags: ["internal"]
---

# List Proposals

`GET /api/internal/proposals`

List proposals with optional filters.

## Query parameters

- `user_id` string
- `org_id` string
- `status` string, nullable — Filter by status: draft, issued, approved, void
- `client_id` string, nullable — Filter by client UUID
- `proposal_number` string, nullable — Filter by proposal number
- `invoice_id` string, nullable — Filter by linked invoice UUID
- `order_by` string, nullable — Column to sort by (e.g., created_at, updated_at, proposal_number)
- `order_desc` boolean, nullable — Sort in descending order (most recent first)
- `limit` integer — Maximum number of proposals to return
- `offset` integer — Number of proposals to skip

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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