List prospect items

GET/api/v2/websets/{webset_id}/items

Returns the authoritative Items snapshot for a Webset. It can be read while discovery is running; provisional=true means an item may still change or be removed. Requires websets:read.

Query parameters

Parameter	Default	Description
`match`	`qualified`	`qualified`, `full`, `partial`, `rejected`, or `verified`.
`detail`	`compact`	`compact`, `standard`, or `full`.
`limit`	`10`	Maximum 50 for `compact`, 25 for `standard`, and 10 for `full`.
`cursor`	None	The previous page's `next_cursor`.

qualified returns full + partial. verified returns full + partial + rejected. An individual item's match.status is only full, partial, or rejected.

In the current weighted-scoring mode, top-level match.score is a 0–100 weighted score: 80–100 is full, 40–79 is partial, and 0–39 is rejected. Per-criterion confidence or score describes one criterion and should not be confused with the top-level score.

cURL
curl "https://revor.ai/api/v2/websets/WEBSET_ID/items?match=qualified&detail=compact&limit=50" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

Detail levels

compact: name, website or profile, industry or title, match status, and score.
standard: adds the complete entity, check counts, and criterion summaries.
full: adds per-criterion reasoning, confidence, and reference URLs.

Response

JSON
{
  "ok": true,
  "request_id": "req_xxx",
  "items": [
    {
      "id": "item-uuid",
      "target_kind": "company",
      "entity": {
        "name": "Example Equipment",
        "website": "https://example.com",
        "industry": "Construction Equipment"
      },
      "match": {
        "status": "full",
        "score": 92
      },
      "provisional": true
    }
  ],
  "detail": "compact",
  "next_cursor": null,
  "has_more": false,
  "webset_status": "verifying",
  "items_revision": 18,
  "stream_cursor": 289
}

Pagination and SSE checkpoint

next_cursor is an opaque REST pagination cursor. stream_cursor is a numeric SSE event cursor. They are not interchangeable.

For multiple pages, retain the first page's stream_cursor + items_revision, follow next_cursor through the remaining pages, then open SSE from the first-page checkpoint. Changes during pagination are replayed from that point. Merge all items by id to tolerate overlap between pages and events.

entity.name is a display name, not a guaranteed unique legal name. Parent companies, regional subsidiaries, or separate entities under one brand may share it. Always use item id as the unique key and use the official website to distinguish company entities.