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

# List webhook endpoints

> Returns the project's webhook endpoints. By default only `ACTIVE` endpoints are returned; pass the `status` query parameter to widen or change the filter (e.g. `ACTIVE,DISABLED`).



## OpenAPI

````yaml /api-reference/openapi.json get /webhooks/
openapi: 3.1.0
info:
  title: Reap API
  version: 1.0.0
  description: Reap platform API
servers:
  - url: https://sandbox.api.reap.global
    description: Sandbox
  - url: https://prod.api.reap.global
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Accounts
  - name: Activities
  - name: Card Designs
  - name: Card Shipments
  - name: Card Transactions
  - name: Cards
  - name: Companies
  - name: Crypto Deposits
  - name: Policies
  - name: Simulation
  - name: Users
  - name: Virtual Asset Postings
  - name: Virtual Assets
  - name: Webhooks
paths:
  /webhooks/:
    get:
      tags:
        - Webhooks
      summary: List webhook endpoints
      description: >-
        Returns the project's webhook endpoints. By default only `ACTIVE`
        endpoints are returned; pass the `status` query parameter to widen or
        change the filter (e.g. `ACTIVE,DISABLED`).
      operationId: list_webhooks
      parameters:
        - name: status
          in: query
          required: false
          schema:
            description: >-
              Filter webhooks by status (comma-separated). Defaults to ACTIVE
              only.
            type: array
            items:
              type: string
              enum:
                - ACTIVE
                - DISABLED
              example: ACTIVE
        - name: Reap-Version
          in: header
          required: true
          schema:
            type: string
            enum:
              - '2025-02-14'
            description: API version (YYYY-MM-DD)
            example: '2025-02-14'
      responses:
        '200':
          description: Webhooks for the project matching the requested status filter.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      $ref: '#/components/schemas/Webhook'
                required:
                  - items
components:
  schemas:
    Webhook:
      type: object
      properties:
        id:
          type: string
          format: uuid
          description: Unique webhook identifier
        name:
          type: string
          description: Human-readable label
        url:
          type: string
          description: HTTPS endpoint that receives signed POSTs
        status:
          type: string
          enum:
            - ACTIVE
            - DISABLED
          description: Lifecycle status. Disabled webhooks receive no deliveries.
          example: ACTIVE
        mode:
          type: string
          enum:
            - NOTIFICATION
            - REQUEST
          description: Interaction pattern of the endpoint.
          example: NOTIFICATION
        lastUsedAt:
          anyOf:
            - type: string
              format: date-time
              pattern: >-
                ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
            - type: 'null'
          description: Timestamp of the most recent successful delivery
        createdAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: ISO 8601 creation timestamp
        updatedAt:
          type: string
          format: date-time
          pattern: >-
            ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
          description: ISO 8601 last update timestamp
      required:
        - id
        - name
        - url
        - status
        - mode
        - lastUsedAt
        - createdAt
        - updatedAt
      description: >-
        Webhook endpoint configuration. The signing secret is never included in
        this response; it is only returned once at create and at rotate-secret
        time.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: API key as Bearer token

````