---
title: "List your webhook endpoints"
method: GET
path: "/v1/webhooks"
---

# List your webhook endpoints

`GET /v1/webhooks`

## Request

- Base URL: `https://api.trackingmcp.com`
- URL: `https://api.trackingmcp.com/v1/webhooks`
- Auth: HTTP bearer

Every endpoint registered by your organisation, newest first. The signing secret is never returned here.

## Response `200`

Your endpoints, under `data.items`.

- object
  - `ok` true
  - `data` object
    - `items` WebhookEndpoint[]
      - `id` string, uuid
      - `url` string, uri
      - `event_types` WebhookEventType[]: The stored subscription, after unrecognised names were filtered out.
      - `description` string, nullable
      - `active` boolean
      - `failure_count` integer: Consecutive delivery failures. Reset to 0 by a PATCH setting active: true.
      - `last_delivery_at` string, date-time, nullable
      - `created_at` string, date-time

## Other responses

- `401`: Missing or invalid API key.
- `500`: `INTERNAL_ERROR` — the list could not be read.

---

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