Get a prospect list

GET/api/v2/websets/{webset_id}

Returns status, progress, criteria, and timestamps for one prospect list. Requires websets:read.

cURL
curl "https://revor.ai/api/v2/websets/WEBSET_ID" \
  -H "Authorization: Bearer sk-revor-REPLACE_ME"

Response

JSON
{
  "ok": true,
  "request_id": "req_xxx",
  "item": {
    "id": "webset-uuid",
    "name": "North American excavator companies",
    "query": "Excavator manufacturers, dealers, and rental providers...",
    "target_kind": "company",
    "status": "searching",
    "progress": {
      "stage": "searching",
      "goal": 25,
      "verify_cap": 75,
      "verified": 0,
      "qualified": 0,
      "full": 0,
      "stop_reason": null,
      "updated_at": "2026-09-24T08:00:00.000Z"
    },
    "criteria": [
      {
        "id": "criterion-1",
        "description": "Manufactures, sells, rents, or repairs excavators",
        "type": "business_fit",
        "weight": 0.65,
        "required": true,
        "active": true
      }
    ],
    "failure": null,
    "created_at": "2026-09-24T07:58:00.000Z",
    "started_at": "2026-09-24T07:58:10.000Z",
    "finished_at": null,
    "updated_at": "2026-09-24T08:00:00.000Z"
  }
}

Progress fields

goal: total qualified results intended for delivery.
verify_cap: maximum candidates this run may verify; it is not a result count.
verified: candidates verified in the current create or Find More run; a new run resets this count.
qualified: current full + partial pool, which may include unreleased overflow.
full: fully matching results.
stop_reason: why the current run stopped.

After Find More, verified can decrease while qualified grows. Treat the Items endpoint as the source of truth for visible results.

Failure

For status=failed, read failure.code. An absent Webset or one owned by another user returns 404 webset_not_found.