---
title: "Page through compact or full search-job results"
method: GET
path: "/api/v1/searches/{id}"
---

# Page through compact or full search-job results

`GET /api/v1/searches/{id}`

## Request

- Base URL: `https://crawdar.com`
- URL: `https://crawdar.com/api/v1/searches/{id}`
- Auth: API key in header `x-job-token`

## Path parameters

- `id` string, uuid, required

## Query parameters

- `cursor` string
- `limit` integer
- `view` 'compact' | 'full'

## Response `200`

A page of results

- SearchJobPage
  - `id` string, uuid, required
  - `status` 'queued' | 'running' | 'completed' | 'failed' | 'canceled', required
  - `progress` object
  - `schemaVersion` string
  - `resultCount` integer, required
  - `returned` integer, required
  - `results` Result[], required
    - `name` string, required
    - `website` string
    - `websiteUrl` string
    - `city` string
    - `email` string
    - `phone` string
    - `prospectStatus` 'qualified' | 'possible', required: Qualified means all retained criteria are confirmed. Possible means one or more criteria remain unknown.
    - `whyMatch` string[], required
    - `criteria` ProspectCriterion[], required
      - `criterion` string, required
      - `status` 'confirmed' | 'unknown' | 'contradicted', required
      - `evidence` string, required
      - `sourceUrl` string, required
    - `contactRoute` ContactRoute, required
      - `status` 'confirmed' | 'route_available' | 'not_found', required
      - `type` 'public_role_email' | 'public_phone' | 'website' | 'none', required
      - `value` string, required
      - `sourceUrl` string, required
      - `confidence` integer, required
      - `reason` string, required
    - `fitStatus` 'verified' | 'likely', required: Verified means every requested qualification check passed. Likely means at least one check is open or unverified.
    - `confidence` integer
    - `entityConfidence` integer, required
    - `qualificationConfidence` integer, required
    - `evidenceQuality` 'strong' | 'moderate' | 'weak'
    - `evidence` Evidence[], required
      - `label` string, required
      - `url` string, uri, required
      - `kind` string, required
    - `qualificationChecks` QualificationCheck[], required
      - `requirement` string, required
      - `status` 'passed' | 'failed' | 'unverified', required
      - `excerpt` string, required
      - `sourceUrl` string, required
  - `nextCursor` string, nullable
  - `diagnostics` Diagnostics
    - `discoveredCandidates` integer, required
    - `inspectedCandidates` integer, required
    - `acceptedResults` integer, required
    - `verifiedResults` integer, required
    - `likelyResults` integer, required
    - `rejectedCandidates` object[], required
      - `name` string, required
      - `url` string, required
      - `reason` string, required
    - `sourceStatus` object[], required
      - `source` string, required
      - `status` 'complete' | 'partial' | 'failed', required
      - `detail` string, required
    - `providerRequests` object
      - `attempted` integer, required
      - `succeeded` integer, required
      - `failed` integer, required
      - `denied` integer, required
  - `warnings` string[]
  - `searchedSources` string[]
  - `createdAt` string, date-time
  - `completedAt` string, date-time, nullable

## Other responses

- `202`: Job is not complete yet
- `404`: Job or capability token not found

---

[API](https://skmtc.dev/crawdar/apis/crawdar-public-api.md) · [All operations](https://skmtc.dev/crawdar/apis/crawdar-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawdar/apis/crawdar-public-api/revisions/355bc1f722ee?raw)