List deals

List all deals in your organization with optional filtering.

GET/api-deals

Try it

GET

API Key (stored locally in your browser only)

Create an API key in your workspace under Settings → Integrations & API.

Query

None.

Requires the contacts:read scope. Returns deals across all contacts in the caller's organization. Designed to support Zapier polling triggers for "New deal" and "Updated deal".

Query parameters

Query

Name	Type	Description
`created_since`	string (ISO 8601)	Filter to deals with created_at >= value.
`updated_since`	string (ISO 8601)	Filter to deals with updated_at >= value.
`contact_id`	uuid	Only deals linked to this contact.
`limit`	integer	Default 100, max 200.
`offset`	integer	Default 0.
`order`	string	asc or desc on created_at. Default desc (newest first).

Example request

bash

curl -X GET \
  'https://api.wundertreos.com/functions/v1/api-deals?created_since=2026-05-01T00:00:00Z&limit=50' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'

Response

json

{
  "data": [
    {
      "id": "d1e2f3a4-1111-2222-3333-444455556666",
      "org_id": "a1b2c3d4-1111-2222-3333-444455556666",
      "contact_id": "c8b1f3a0-4d2e-4f9a-9b1c-2d4e5f6a7b8c",
      "company_id": null,
      "pipeline_id": "p1a2b3c4-1111-2222-3333-444455556666",
      "stage_id": "s1a2b3c4-1111-2222-3333-444455556666",
      "title": "Acme — Annual plan",
      "value": 12000,
      "currency": "USD",
      "expected_close_date": "2026-06-30",
      "assigned_to": "u1b1f3a0-4d2e-4f9a-9b1c-2d4e5f6a7b8c",
      "notes": null,
      "won_at": null,
      "lost_at": null,
      "lost_reason": null,
      "created_at": "2026-05-01T10:00:00Z",
      "updated_at": "2026-05-17T12:00:00Z",
      "created_by": "u1b1f3a0-4d2e-4f9a-9b1c-2d4e5f6a7b8c"
    }
  ]
}

Response

Field	Type	Description
`data[].id`	uuid
`data[].org_id`	uuid
`data[].contact_id`nullable	uuid	Linked contact.
`data[].company_id`nullable	uuid	Linked company.
`data[].pipeline_id`	uuid	Pipeline this deal lives in.
`data[].stage_id`	uuid	Current stage within the pipeline.
`data[].title`	string
`data[].value`nullable	number	Monetary value of the deal.
`data[].currency`nullable	string	ISO 4217 code (e.g. USD).
`data[].expected_close_date`nullable	string (ISO 8601 date)
`data[].assigned_to`nullable	uuid	Owner user ID.
`data[].notes`nullable	string
`data[].won_at`nullable	string (ISO 8601)
`data[].lost_at`nullable	string (ISO 8601)
`data[].lost_reason`nullable	string
`data[].created_at`	string (ISO 8601)
`data[].updated_at`	string (ISO 8601)
`data[].created_by`nullable	uuid

PreviousSearch contacts Next List activities