---
title: "V1 List Deals"
method: GET
path: "/api/v1/deals"
tags: ["public-api"]
---

# V1 List Deals

`GET /api/v1/deals`

## Request

- Base URL: `https://api.general.legal`
- URL: `https://api.general.legal/api/v1/deals`
- Auth: HTTP bearer

List the caller's matters (paginated, optional status filter).

## Query parameters

- `page` integer
- `page_size` integer
- `status` 'new' | 'in_progress' | 'ready_for_review' | 'awaiting_client' | 'closed', nullable

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- PaginatedResponseDealSummary
  - `items` DealSummary[], required
    - `id` union, required
      - string, uuid
      - string
    - `name` string, nullable
    - `status` string, nullable
    - `created_at` union
      - string, date-time
      - string
    - `contracts` ContractSummary[], nullable
      - `id` union, required
        - string, uuid
        - string
      - `name` string, nullable
      - `contract_type` string, nullable
      - `versions` VersionSummary[], nullable
        - `id` union
          - string, uuid
          - string
        - `version_number` integer, nullable
        - `file_name` string, nullable
    - `initial_request` string, nullable
  - `total` integer, required
  - `page` integer, required
  - `page_size` integer, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation Error
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/general/apis/general-legal-api.md) - [All operations](https://skmtc.dev/general/apis/general-legal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/general/apis/general-legal-api/revisions/4a9709568945?raw)