Get one run with the records it delivered

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

import requests

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

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/{run_id}/summary', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": 64200,
  "started_at": "2026-07-16T03:19:00Z",
  "completed_at": "2026-07-16T03:20:00Z",
  "status": "SUCCESS",
  "failure_reason": null,
  "records_searched": 1204,
  "records_after_filter": 12,
  "new_records_count": 1,
  "credits_deducted": 5,
  "logs": [
    {
      "activity": "25 new records",
      "timestamp": "2026-08-24T15:23:13.847993+00:00"
    }
  ],
  "notifications": [
    {
      "sent_at": "2026-07-16T03:20:00Z",
      "http_status": 200,
      "payload": {
        "subscription_id": 46936,
        "event_type": "indb:entity:person",
        "timestamp": "2026-07-16T03:20:00Z",
        "notifications": [
          {
            "uid": "person_6324687_64200",
            "changes": [
              {
                "field": "experience.employment_details.current",
                "type": "added",
                "new_elements": [
                  {
                    "title": "Head of Data",
                    "name": "Example Corp",
                    "start_date": "2026-07-01"
                  }
                ]
              }
            ],
            "record": {
              "crustdata_person_id": 6324687,
              "basic_profile": {
                "name": "Sherry Robinson",
                "current_title": "Head of Data"
              }
            }
          }
        ]
      }
    }
  ]
}

Get a watch run summary

Returns one run in full: its counts, its per-stage activity log, and every delivery attempt with the records it carried under notifications[].payload.notifications[]. That is the same record shape your channel receives, so a watch is readable here even when no channel is configured.

Records are returned only for a run whose status is SUCCESS. A run can leave rows behind without ever paying for or delivering them, and those rows must not be readable. The run itself, with its status, counts, and logs, is still returned so you can see what happened.

GET

https://api.crustdata.com

watch

{dataset}

{watch_id}

runs

{run_id}

summary

Get one run with the records it delivered

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

import requests

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

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/{run_id}/summary', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "id": 64200,
  "started_at": "2026-07-16T03:19:00Z",
  "completed_at": "2026-07-16T03:20:00Z",
  "status": "SUCCESS",
  "failure_reason": null,
  "records_searched": 1204,
  "records_after_filter": 12,
  "new_records_count": 1,
  "credits_deducted": 5,
  "logs": [
    {
      "activity": "25 new records",
      "timestamp": "2026-08-24T15:23:13.847993+00:00"
    }
  ],
  "notifications": [
    {
      "sent_at": "2026-07-16T03:20:00Z",
      "http_status": 200,
      "payload": {
        "subscription_id": 46936,
        "event_type": "indb:entity:person",
        "timestamp": "2026-07-16T03:20:00Z",
        "notifications": [
          {
            "uid": "person_6324687_64200",
            "changes": [
              {
                "field": "experience.employment_details.current",
                "type": "added",
                "new_elements": [
                  {
                    "title": "Head of Data",
                    "name": "Example Corp",
                    "start_date": "2026-07-01"
                  }
                ]
              }
            ],
            "record": {
              "crustdata_person_id": 6324687,
              "basic_profile": {
                "name": "Sherry Robinson",
                "current_title": "Head of Data"
              }
            }
          }
        ]
      }
    }
  ]
}

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

run_id

integer

required

The run's id, from runs[].id on the run-history endpoint.

Example:

54811

Response

The run, its logs, and its deliveries.

One run in full, with its counts, its activity log, and its deliveries.

integer

Example:

64200

started_at

string<date-time>

Example:

"2026-07-16T03:19:00Z"

completed_at

string<date-time> | null

Example:

"2026-07-16T03:20:00Z"

status

enum<string>

Available options:

RUNNING,

SUCCESS,

FAILED,

SKIPPED

Example:

"SUCCESS"

failure_reason

string | null

Example:

null

records_searched

integer

Records the run's query matched before any filtering.

Example:

1204

records_after_filter

integer

Records left after filtering, before the new-record check.

Example:

12

new_records_count

integer

Records this run delivered.

Example:

1

credits_deducted

number

Example:

5

logs

object[]

The run's per-stage activity log.

Show child attributes

notifications

object[]

Every delivery this run attempted, with the records it carried. Empty unless status is SUCCESS: a run can leave rows behind without ever paying for or delivering them, and those rows are not readable here.

Show child attributes