Search scored accounts (cursor-paginated)

GET/accounts

Requires scope: read:accounts

Parameters

Parameter	In	Type	Description
`min_score`	query	number	Minimum In-Market score (0-100)
`tier`	query	string
`status`	query	string
`icp_profile`	query	string	Only accounts scored for this ICP profile
`limit`	query	integer
`cursor`	query	string	Opaque keyset cursor from next_cursor
`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 accounts
`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/accounts?min_score=25&tier=value" \
  -H "Authorization: Bearer $VERGIO_API_KEY" \
  -H "Idempotency-Key: replace-with-a-stable-request-id"

Response (200)

{
  "accounts": [
    {
      "storeId": "b7c9a2e1-0000-4000-8000-000000000000",
      "domain": "string",
      "rank": 0,
      "tier": "string",
      "status": "string",
      "inMarket": 0,
      "fit": 0,
      "fitDetails": {},
      "intent": 0,
      "opportunity": 0,
      "reasoning": "string",
      "accountScoreId": "b7c9a2e1-0000-4000-8000-000000000000",
      "icpProfile": {
        "id": null,
        "name": null
      },
      "why": [
        null
      ],
      "generationId": "b7c9a2e1-0000-4000-8000-000000000000",
      "policy": "primary",
      "confidence": 0,
      "leadConfirmed": true,
      "firstObservedAt": "2026-07-06T12:00:00Z",
      "changedAt": "2026-07-06T12:00:00Z",
      "confirmedAt": "2026-07-06T12:00:00Z",
      "decisionAt": "2026-07-06T12:00:00Z",
      "scoreVersion": "string",
      "matchVersion": "string",
      "offering": {},
      "whyNow": {},
      "matchCase": {}
    }
  ],
  "next_cursor": "string"
}