List a watch's runs

curl --request GET \
  --url https://api.crustdata.com/watch/{dataset}/{watch_id}/runs \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-version: <x-api-version>'

import requests

url = "https://api.crustdata.com/watch/{dataset}/{watch_id}/runs"

headers = {
    "x-api-version": "<x-api-version>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-api-version': '<x-api-version>', Authorization: 'Bearer <token>'}
};

fetch('https://api.crustdata.com/watch/{dataset}/{watch_id}/runs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "runs": [
    {
      "id": 54811,
      "started_at": "2026-08-04T05:30:00Z",
      "completed_at": "2026-08-04T05:32:47Z",
      "status": "SUCCESS",
      "failure_reason": null,
      "new_records_count": 3,
      "credits_deducted": 1.5,
      "notification_http_status": 200
    }
  ],
  "next_cursor": 54790,
  "total_count": 42
}

List watch runs

Returns the watch’s runs, newest first, with cursor pagination. Works for both watch kinds. The read paths drop the search/ segment that discovery create and manage use, so a discovery watch created at /watch/job/search reads its runs at /watch/job/{watch_id}/runs.

Check notification_http_status before concluding that a quiet channel means nothing happened: a non-2xx there means the run found matches and the delivery itself was rejected. Pass only_credited=true to see only the runs that actually charged you.

GET

https://api.crustdata.com

/

watch

/

{dataset}

/

{watch_id}

/

runs

List a watch's runs

curl --request GET \
  --url https://api.crustdata.com/watch/{dataset}/{watch_id}/runs \
  --header 'Authorization: Bearer <token>' \
  --header 'x-api-version: <x-api-version>'

import requests

url = "https://api.crustdata.com/watch/{dataset}/{watch_id}/runs"

headers = {
    "x-api-version": "<x-api-version>",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'x-api-version': '<x-api-version>', Authorization: 'Bearer <token>'}
};

fetch('https://api.crustdata.com/watch/{dataset}/{watch_id}/runs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "runs": [
    {
      "id": 54811,
      "started_at": "2026-08-04T05:30:00Z",
      "completed_at": "2026-08-04T05:32:47Z",
      "status": "SUCCESS",
      "failure_reason": null,
      "new_records_count": 3,
      "credits_deducted": 1.5,
      "notification_http_status": 200
    }
  ],
  "next_cursor": 54790,
  "total_count": 42
}

Authorizations

Authorization

string

header

required

API key passed as a Bearer token in the Authorization header.

Headers

x-api-version

enum<string>

default:2025-11-01

required

API version to use. 2025-11-01 is the only accepted value. Send it on every call: it is enforced today on POST /watch/{dataset}/search, where a missing or unrecognized value returns 400, and the other watch routes accept a request without it rather than relying on that.

Available options:

2025-11-01

Example:

"2025-11-01"

Path Parameters

dataset

enum<string>

required

The dataset the watch is built on.

Available options:

person,

company,

job

Example:

"person"

watch_id

integer

required

The watch's id, returned when it was created.

Example:

46936

Query Parameters

limit

integer

default:20

Runs per page.

Required range: 1 <= x <= 1000

Example:

20

cursor

integer

The next_cursor from the previous page. Runs with an id below this are returned.

Example:

54811

only_credited

boolean

default:false

Return only runs that deducted credits.

Example:

false

Response

A page of runs, newest first.

A page of runs, newest first.

runs

object[]

Show child attributes

next_cursor

integer | null

Pass this back as cursor for the next page. null on the last page.

Example:

54790

total_count

integer

All runs matching the query, not just this page.

Example:

42

Related topics

List discovery watches List entity watches Company Entity Watcher Person Entity Watcher Get a watch run summary

⌘I