---
title: "The account's webhook endpoints"
method: GET
path: "/v1/webhook-endpoints"
tags: ["Webhooks"]
---

# The account's webhook endpoints

`GET /v1/webhook-endpoints`

## Request

- Base URL: `https://carbonguru.io`
- URL: `https://carbonguru.io/v1/webhook-endpoints`
- Auth: HTTP bearer

No secret is in this answer. A secret appears in exactly two responses: creating an endpoint and rotating its secret.

## Response `200`

The registered endpoints.

- object
  - `endpoints` WebhookEndpoint[], required
    - `id` string
    - `url` string
    - `events` string[]: The events this endpoint subscribes to.
    - `status` string: active or disabled. An endpoint is disabled after repeated delivery failures.
    - `created_at` string, nullable
    - `failure_count` integer, nullable: Consecutive failed deliveries. It resets on a success.
    - `disabled_at` string, nullable

## Other responses

- `401`: No valid credential. Every authentication failure returns this one document.
- `403`: A missing scope, an exhausted analysis allowance, or an object that is not the caller's.

---

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