---
title: "This account's webhook endpoints (url, events, whether paused, the secret's last four characters) and watches. Needs the webhooks scope."
method: GET
path: "/webhooks"
---

# This account's webhook endpoints (url, events, whether paused, the secret's last four characters) and watches. Needs the webhooks scope.

`GET /webhooks`

## Request

- Base URL: `https://permtracker.app/v1`
- URL: `https://permtracker.app/v1/webhooks`
- Auth: HTTP bearer

Needs a key with the webhooks scope.

## Response `200`

The answer, with `meta.source`, `meta.asOf` and `meta.url` naming where it came from.

- object
  - `data` unknown
  - `meta` object

## Other responses

- `400`: The request isn't valid. Not counted.
- `401`: No key, or a key we don't recognise.
- `403`: The key lacks the scope, or the plan lacks the feature. Not counted.
- `404`: No such record. Counted.
- `429`: A minute, day or month limit. Retry-After says when it lifts.

---

[API](https://skmtc.dev/permtracker/apis/perm-tracker-api.md) · [All operations](https://skmtc.dev/permtracker/apis/perm-tracker-api/llms.txt) · [OpenAPI document](https://skmtc.dev/permtracker/apis/perm-tracker-api/revisions/9f3b735c0dca?raw)