Deals
One row per deal: pipeline, stage, status, value, MRR, temperature, probability, person, company, origin, lost reason and lifecycle dates.
dateFrom and dateTo filter by created_at (inclusive days, YYYY-MM-DD).
Rows are sorted by id, integration_id, inserted_at and paginated with page/limit; meta.hasNextPage says whether another page exists.
Responses are cached for 30 minutes.
ClientIdAuthClientSecretAuthx-client-id<token>Client ID
x-client-secret<token>Client secret
organizationId*stringOrganization that owns the connected accounts.
uuidintegrationId?stringOne connected account of this integration (integration_id of the rows). Omit it to read every account of the organization.
length <= 255dateFrom?stringFirst day (inclusive) of created_at, YYYY-MM-DD.
datedateTo?stringLast day (inclusive) of created_at, YYYY-MM-DD. Must not be before dateFrom.
datepage?integerPage number, starting at 1.
1 <= value <= 10000001limit?integerRows per page (max 5000).
1 <= value <= 5000500One page of rows
application/json- response
data*array<>meta*curl -X GET "https://example.com/v1/piperun/deals?organizationId=3f2b8c1e-5d4a-4e6f-9a7b-1c2d3e4f5a6b&dateFrom=2026-10-01&dateTo=2026-10-31"{ "data": [ { "organization_id": "3f2b8c1e-5d4a-4e6f-9a7b-1c2d3e4f5a6b", "integration_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d", "user_id": "123456", "document_id": "123456", "integration_name": "example", "id": "123456", "pipeline_id": "123456", "stage_id": "123456", "owner_id": "123456", "person_id": "123456", "company_id": "123456", "origin_id": "123456", "lost_reason_id": "123456", "started_in_stage_id": "123456", "status": "1250", "value": "125.50", "value_mrr": "125.50", "temperature": "example", "probability": "125.50", "deleted": true, "freezed": true, "created_at": "2026-10-01T12:00:00.000Z", "updated_at": "2026-10-01T12:00:00.000Z", "closed_at": "2026-10-01T12:00:00.000Z", "probably_closed_at": "2026-10-01T12:00:00.000Z", "last_stage_updated_at": "2026-10-01T12:00:00.000Z", "stage_changed_at": "2026-10-01T12:00:00.000Z", "last_contact_at": "2026-10-01T12:00:00.000Z", "inserted_at": "2026-10-01T12:00:00.000Z" } ], "meta": { "page": 1, "limit": 500, "hasNextPage": false, "hasPreviousPage": false }}