GET /v1/deals

List deals

Cursor-paginated deals of the tenant with filters and search. Financial data (margin, items, payments) is never returned. Requires scope write:deals.

Автентифікація: заголовок Authorization: Bearer rv_live_... (API-ключі та scopes)
Потрібний scope: write:deals

Опис операції, параметрів і полів походить зі специфікації OpenAPI (openapi.json) і подається англійською, як у самому API.

Параметри

Поле	Де	Тип	Обов’язк.	Опис
`q`	query	`string`	ні	Deal number, VIN fragment, client name or vehicle make/model.
`status`	query	`string`	ні	Comma-separated deal statuses.
`open_only`	query	`"true" \| "false"`	ні	Exclude closed/lost/cancelled.
`contact_id`	query	`string (uuid)`	ні
`manager_id`	query	`string (uuid)`	ні
`type`	query	`string`	ні	Comma-separated: full_service,auction_only,logistics_only,resale.
`sort`	query	`"createdAt" \| "updatedAt" \| "number" \| "etaDelivery"`	ні
`dir`	query	`"asc" \| "desc"`	ні
`cursor`	query	`string`	ні
`limit`	query	`integer`	ні

A page of deals.

application/json · Схема: DealPage

Поле	Тип	Обов’язк.	Опис
`items`	`object[]`	так
`items[].id`	`string (uuid)`	ні
`items[].number`	`string`	ні
`items[].status`	`"lead" \| "consult" \| "contract_signed" \| "deposit_paid" \| "searching" \| "bid_approved" \| "won" \| "paid_to_auction" \| "pickup_scheduled" \| "at_us_warehouse" \| "loaded" \| "in_transit_sea" \| "at_eu_port" \| "inland_to_border" \| "customs_clearing" \| "customs_cleared" \| "certification" \| "registration" \| "ready_for_handover" \| "handed_over" \| "closed" \| "lost" \| "cancelled" \| "on_hold" \| "dispute"`	ні
`items[].type`	`"full_service" \| "auction_only" \| "logistics_only" \| "resale"`	ні
`items[].currency`	`"UAH" \| "USD" \| "EUR" \| "PLN" \| "GEL"`	ні
`items[].contactId`	`string (uuid)`	ні
`items[].contactName`	`string \| null`	ні
`items[].managerId`	`string \| null (uuid)`	ні
`items[].managerName`	`string \| null`	ні
`items[].vehicle`	`object`	ні
`items[].etaDelivery`	`string \| null`	ні	ISO 8601 date-time (UTC).
`items[].sla`	`object`	ні
`items[].createdAt`	`string`	ні	ISO 8601 date-time (UTC).
`items[].updatedAt`	`string`	ні	ISO 8601 date-time (UTC).
`nextCursor`	`string \| null`	так