> ## Documentation Index
> Fetch the complete documentation index at: https://api.csboard.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /v1/webhooks — List Your Webhook Endpoints

> List every webhook endpoint on your account with its delivery health — last success, last failure, and the endpoint's own error text.

Returns your registered endpoints together with the health fields that tell you whether push is actually working: `last_success_at`, `last_failure_at`, the verbatim `last_error` your server produced, and `consecutive_failures`. At 50 consecutive failures an endpoint is auto-disabled, so a rising counter here is the early warning.

See the [Webhooks guide](/guides/webhooks) for signature verification and the payload schema.

**Authentication required.** Send your key as `Authorization: Bearer csb_pub_...`. A read key is enough — managing webhooks moves no money.


## OpenAPI

````yaml GET /webhooks
openapi: 3.1.0
info:
  title: CSBoard API
  version: 1.0.0
  description: >-
    Market data over the CSBoard marketplace — live listings, floats, stickers,
    minAsk prices, FX rates — plus opt-in buying straight from your balance.
    Free to read, key-gated, built for automation.
  contact:
    name: CSBoard
    url: https://csboard.com/docs
servers:
  - url: https://csboard.com/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Status
    description: Liveness and freshness probes.
  - name: Market data
    description: Read the live catalog, prices, and FX rates.
  - name: Trading
    description: Buy listings from your CSBoard balance. Opt-in, key-gated.
  - name: Account
    description: Your balance, settled funds, and trading status.
  - name: Webhooks
    description: Register an endpoint and receive signed order updates instead of polling.
paths:
  /webhooks:
    get:
      tags:
        - Webhooks
      summary: List your webhook endpoints
      description: >-
        Your registered endpoints with their delivery health — last success,
        last failure, the endpoint's own error text, and the consecutive-failure
        counter that drives auto-disable.
      operationId: listWebhooks
      responses:
        '200':
          description: Your endpoints.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        url:
                          type: string
                          format: uri
                        events:
                          type: array
                          items:
                            type: string
                            enum:
                              - order.updated
                              - webhook.test
                          description: >-
                            Subscribed event types. An empty request value means
                            all of them; the response always lists them
                            explicitly.
                        enabled:
                          type: boolean
                        description:
                          type: string
                          nullable: true
                        last_success_at:
                          type: string
                          format: date-time
                          nullable: true
                        last_failure_at:
                          type: string
                          format: date-time
                          nullable: true
                        last_error:
                          type: string
                          nullable: true
                          description: >-
                            Verbatim reason the last attempt failed — HTTP
                            status, timeout, or URL rejection.
                        consecutive_failures:
                          type: integer
                          description: >-
                            Reset on any success. At 50 the endpoint is
                            auto-disabled.
                        created_at:
                          type: string
                          format: date-time
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Send your key as a Bearer token on every request: `Authorization: Bearer
        csb_pub_...`. Generate keys in your CSBoard profile.

````