---
title: "List webhook endpoints"
method: GET
path: "/webhook-endpoints"
tags: ["Webhooks"]
---

# List webhook endpoints

`GET /webhook-endpoints`

## Request

- Base URL: `https://api.braiv.co/v1`
- URL: `https://api.braiv.co/v1/webhook-endpoints`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-Api-Key`

Lists active endpoints owned by the caller. Signing secrets are never included. Required scope: `webhooks:write`.

## Response `200`

Active webhook endpoints.

- WebhookEndpointList
  - `endpoints` WebhookEndpoint[], required: Active endpoints owned by the caller.
    - `id` string, required: Webhook endpoint ID.
    - `url` string, uri, required: Registered HTTPS delivery destination.
    - `createdAt` FirestoreTimestamp, required: Firestore timestamp as serialized by the live Express handler.
      - `_seconds` integer, required: Whole seconds since the Unix epoch.
      - `_nanoseconds` integer, required: Fractional nanoseconds within the second.

## Other responses

- `401`: A supported authentication header is missing or contains an invalid Public API key.
- `403`: Authentication succeeded, but the required scope, workspace role, or resource permission is missing.
- `429`: The API key exceeded its allowed concurrency or request rate. Retry after in-flight work completes or the limit resets.
- `500`: An unexpected server error occurred.

---

[API](https://skmtc.dev/braiv/apis/braiv-public-api.md) - [All operations](https://skmtc.dev/braiv/apis/braiv-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/braiv/apis/braiv-public-api/revisions/8ed0fd0d0a6f?raw)