> ## 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/{id}/deliveries — Delivery History

> Inspect what we sent, how many attempts it took, and exactly what your server answered.

The self-serve answer to "did you actually send it?". Every attempt is recorded with the payload we POSTed, the response status, the error text, and — for anything still pending — when the next retry is due.

Filter with `?status=pending`, `delivered`, or `failed`.

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


## OpenAPI

````yaml GET /webhooks/{id}/deliveries
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/{id}/deliveries:
    get:
      tags:
        - Webhooks
      summary: List delivery attempts
      description: >-
        What we sent, how many times we tried, and what your server answered —
        including the failed attempts and their error text. This is the
        self-serve answer to "did you actually send it?".
      operationId: listWebhookDeliveries
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
        - name: status
          in: query
          description: Filter by delivery state.
          schema:
            type: string
            enum:
              - pending
              - delivered
              - failed
        - name: limit
          in: query
          description: 1–100, default 50.
          schema:
            type: integer
            default: 50
            maximum: 100
      responses:
        '200':
          description: Most recent attempts first.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        event_id:
                          type: string
                          description: Stable per (order, state). Dedupe on this.
                        event_type:
                          type: string
                        status:
                          type: string
                          enum:
                            - pending
                            - delivered
                            - failed
                        attempts:
                          type: integer
                        response_status:
                          type: integer
                          nullable: true
                        last_error:
                          type: string
                          nullable: true
                        next_attempt_at:
                          type: string
                          format: date-time
                          nullable: true
                        delivered_at:
                          type: string
                          format: date-time
                          nullable: true
                        created_at:
                          type: string
                          format: date-time
                        payload:
                          type: object
                          description: The exact envelope we POSTed.
        '404':
          description: '`not_found`.'
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.

````