---
title: "List Deals"
method: GET
path: "/deals"
tags: ["deals"]
---

# List Deals

`GET /deals`

List deals for the current organization.

## Query parameters

- `cursor` string, nullable — Cursor for pagination
- `limit` integer — Number of items per page
- `search` string, nullable — Search term for filtering deals
- `status_filter` 'active' | 'archived' | 'deleted' — Status of a CRM entity (shared across types).
- `sync_status` 'synced' | 'pending_crm' | 'sync_failed' | 'not_synced' — Status of the synchronization with CRM systems.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- DealPaginatedResult — Paginated result for deals.
  - `items` DealResult[], required — List of deals
    - `id` string, uuid, required — Deal ID
    - `name` string, required — Name of the deal
    - `organization_id` string, uuid, required — Organization ID
    - `crm_provider` 'hubspot' | 'attio' | 'none', required — Provider of the CRM system.
    - `user_id` string, uuid, nullable — User ID
    - `provider_deal_id` string, nullable — Deal ID in the provider CRM system
    - `companies_ids` string[], required — Company IDs
    - `contacts_ids` string[], required — Contact IDs
    - `deal_stage` string, nullable — Stage of the deal
    - `deal_amount` number, nullable — Amount of the deal
    - `deal_currency` string, nullable — Currency of the deal
    - `deal_close_date` string, date-time, nullable — Expected close date
    - `deal_owner_crm_id` string, nullable — Owner ID in the CRM system
    - `status` 'active' | 'archived' | 'deleted', required — Status of a CRM entity (shared across types).
    - `sync_status` 'synced' | 'pending_crm' | 'sync_failed' | 'not_synced', required — Status of the synchronization with CRM systems.
    - `last_crm_sync_timestamp` string, date-time, nullable — Timestamp of the last CRM synchronization
    - `nomi_insights_json` object, nullable — Nomi-generated insights about the deal
    - `created_at` string, date-time, required — Creation timestamp
    - `updated_at` string, date-time, required — Last update timestamp
    - `intelligence_id` string, uuid, nullable — ID of the intelligence data
    - `associated_calls` integer — Number of calls associated with this deal
    - `associated_events` integer — Number of calendar events associated with this deal
  - `next_cursor` string, nullable — Cursor for the next page
  - `has_more` boolean, required — Whether there are more results

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/nomi/apis/fastapi.md) · [All operations](https://skmtc.dev/nomi/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nomi/fastapi/revisions/63a2f545499c/schema)