---
title: "ListWebhooks"
method: GET
path: "/api/v2/shipping/webhooks"
tags: ["ShippingV2Service"]
---

# ListWebhooks

`GET /api/v2/shipping/webhooks`

## Request

- Base URL: `https://api.worldmonitor.app`
- URL: `https://api.worldmonitor.app/api/v2/shipping/webhooks`
- Auth: one of:
  - API key in header `X-WorldMonitor-Key`
  - API key in header `X-Api-Key`
  - HTTP bearer

ListWebhooks returns the caller's registered webhooks filtered by the SHA-256 owner tag of the calling API key. The `secret` is intentionally omitted from the response; use rotate-secret to obtain a new one. PRO-gated. Requires an active Pro subscription.

## Query parameters

- `jmespath` string

## Response `200`

OK

- WorldmonitorShippingV2ListWebhooksResponse: ListWebhooksResponse wire shape preserved exactly: the `webhooks` field name and the omission of `secret` are part of the partner contract.
  - `webhooks` WorldmonitorShippingV2WebhookSummary[]
    - `subscriberId` string
    - `callbackUrl` string
    - `chokepointIds` string[]
    - `alertThreshold` integer
    - `createdAt` string: ISO-8601 timestamp of registration.
    - `active` boolean
    - `eventType` string: As registered; see RegisterWebhookRequest.
    - `countries` string[]
    - `minLiveSignal` integer
    - `scope` WorldmonitorShippingV2WebhookScope: Per-event filters for occurrence events. Each key applies to the events named in its comment; the handler validates against shared/event-triggers.json and stores the defaults.
      - `keywords` string[]
      - `categories` string[]
      - `importanceFloor` integer: news.breaking: importanceScore floor, 0-100 (default 69).
      - `severityFloor` string: news.breaking: `critical` or `high` (default high).
      - `countries` string[]
      - `hazardTypes` string[]
      - `minMagnitude` number, double: natural.hazard: earthquake magnitude floor, 4.5-9.5 (default 5.5).
      - `minAlertLevel` string: natural.hazard: GDACS `Orange` or `Red` (default Orange).
      - `assetClasses` string[]
      - `symbols` string[]
      - `minAbsPct` number, double: market.move: |changePct| floor, 5-100 (default 10).
      - `direction` string: market.move: `up`, `down` or `any` (default any).

## Other responses

- `400`: Validation error
- `401`: Missing or invalid API key.
- `403`: Pro subscription required.
- `429`: Rate limit exceeded.
- `503`: Service unavailable. Billing-verification responses include code and X-Billing-Verification; other gateway infrastructure failures use the generic GatewayError shape.
- `default`: Gateway or handler error response.

---

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