List your pipeline deals (cursor-paginated)

GET/deals

Requires scope: read:accounts

Parameters

Parameter	In	Type
`store_id`	query	string
`stage`	query	"contacted" \| "replied" \| "call_booked" \| "proposal" \| "won" \| "lost"
`limit`	query	integer
`cursor`	query	string

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=value" \
  -H "Authorization: Bearer $VERGIO_API_KEY"

Response (200)

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