GET /v1/watches/{id}

Call	GET /v1/watches/{id}
Price	free
Scope	watches:manage
Operation id	getWatch

What it does

One watch with its ICP, min_p, event types and status. Call it after creating a watch to see whether the URL passed the challenge (active) or is still pending_verification. Free. Scope: watches:manage.

Example request

Copy it as curl. Set VERDICT_API_KEY first; uuidgen makes a fresh Idempotency-Key.

Request

curl -X GET 'https://api.askverdict.io/v1/watches/wch_01JC3Z4Y8R9K2M5N7P1Q3S5T7V' \
  -H "Authorization: Bearer $VERDICT_API_KEY"

Example response

200: The watch.

200 response

{
  "id": "wch_01JC3Z4Y8R9K2M5N7P1Q3S5T7V",
  "project_id": "prj_01JC3Z4Y8R9K2M5N7P1Q3S5T7V",
  "icp_id": "icp_01JC3Z4Y8R9K2M5N7P1Q3S5T7V",
  "webhook_url": "https://agent.northwind-ops.io/hooks/verdict",
  "min_p": 0.7,
  "types": [
    "filing",
    "fund_raise",
    "officer_change"
  ],
  "status": "pending_verification",
  "created_at": "2026-11-07T14:10:00Z",
  "updated_at": "2026-11-07T14:10:00Z"
}

Parameters

Name	In	Type	Required	Description
id	path	string	yes	The watch id.
x-verdict-version	header	string	no	API version to use, a date. Defaults to the version current when the key was created. The current version is 2026-11-01.

Response fields (200)

Schema Watch.

Field	Type	Required	Description
id	string	yes	The watch id.
project_id	string	yes	Project the watch belongs to.
icp_id	string	yes	ICP profile events are scored for.
webhook_url	string (uri)	yes	Delivery endpoint.
min_p	number	yes	Minimum relevant delivered.
types	array of enum: “filing”, “registration”, “officer_change”, “ownership_change”, “lei_change”, “address_change”, “fund_raise”, “insider_trade”, “patent_filing”, “litigation”, “news_mention”, “repo_activity”, “hiring_aggregate”	yes	Event types watched.
status	enum: “pending_verification”, “active”, “paused”, “deleted”	yes	Lifecycle status.
created_at	string (date-time)	yes	When the watch was created.
updated_at	string (date-time)	yes	When the watch last changed.

Errors

Errors are RFC 9457 problem details and are never billed. Branch on type. See Errors.

Status	Meaning
400	Invalid request: malformed JSON, an unknown field, a failed constraint or a size limit (invalid_request).
401	Missing, malformed, revoked or expired API key, or a bad webhook signature (unauthorized).
403	The key lacks the scope this operation needs (forbidden_scope).
404	The resource does not exist in this organization (not_found).
429	Rate limited (rate_limited). Wait Retry-After seconds.
500	Unexpected server error (internal). Not billed; retry with the same Idempotency-Key.

Try it

Open the interactive reference to send this request from the browser. The full document is at /openapi.json.