List your pipeline deals (cursor-paginated)

GET/deals

Requires scope: read:accounts

Parameters

Parameter	In	Type	Description
`store_id`	query	string
`stage`	query	"discovery" \| "qualifying" \| "proposal" \| "negotiation" \| "won" \| "lost"
`limit`	query	integer
`cursor`	query	string
`Idempotency-Key`required	header	string	Stable logical request ID required for every machine mutation; exact retries replay and changed inputs conflict.

Responses

Status	Description
`200`	A page of deals
`401`	Missing or invalid API key
`403`	Key lacks the required scope
`429`	Rate limit exceeded (see Retry-After)

Is this page helpful?

Request

curl "https://vergio.ai/api/v1/deals?store_id=b7c9a2e1-0000-4000-8000-000000000000&stage=discovery" \
  -H "Authorization: Bearer $VERGIO_API_KEY" \
  -H "Idempotency-Key: replace-with-a-stable-request-id"

Response (200)

{
  "deals": [
    {
      "id": "b7c9a2e1-0000-4000-8000-000000000000",
      "storeId": "b7c9a2e1-0000-4000-8000-000000000000",
      "accountName": "string",
      "domain": "string",
      "name": "string",
      "value": 0,
      "dealKind": "one_off",
      "currency": "string",
      "stage": "discovery",
      "ownerUserId": "b7c9a2e1-0000-4000-8000-000000000000",
      "nextStep": "string",
      "nextStepDue": "string",
      "source": "string",
      "emailPermissionStatus": "unknown",
      "emailPermissionSource": "direct_request",
      "emailPermissionConfirmedAt": "2026-07-06T12:00:00Z",
      "version": 0,
      "createdAt": "2026-07-06T12:00:00Z",
      "updatedAt": "2026-07-06T12:00:00Z"
    }
  ],
  "next_cursor": "string"
}