# List Webhooks

Retrieve a paginated list of all webhook subscriptions for your account.

Endpoint: GET /webhooks
Version: 1.0.0
Security: bearerAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer JWT

## Query parameters:

  - `eventType` (string)
    Filter by event type

  - `active` (boolean)
    Filter by active status

  - `page` (integer)
    Page number (starts at 1)

  - `pageSize` (integer)
    Number of items per page (max 100)

## Response 200:

  - `200` (unknown)
    Successful response

## Response 200 fields (application/json):

  - `data` (array)

  - `data.uuid` (string)
    Unique identifier for the webhook
    Example: 550e8400-e29b-41d4-a716-446655440000

  - `data.eventType` (string)
    The event type this webhook subscribes to
    Example: PdvRequestCompleted

  - `data.clientUrl` (string)
    The URL where webhook payloads are delivered
    Example: https://your-tms.example.com/webhooks/trucker-tools

  - `data.isActive` (boolean)
    Whether the webhook is currently active
    Example: true

  - `data.createdAt` (string)
    When the webhook was created
    Example: 2024-05-24T19:50:18.053Z

  - `pagination` (object)

  - `pagination.page` (integer)
    Current page number
    Example: 1

  - `pagination.pageSize` (integer)
    Number of items per page
    Example: 20

  - `pagination.totalPages` (integer)
    Total number of pages
    Example: 1

  - `pagination.totalCount` (integer)
    Total number of webhooks
    Example: 1

## Response 401:

  - `401` (unknown)
    Unauthorized - Invalid or expired token

## Response 401 fields (application/json):

  - `statusCode` (integer)
    HTTP status code
    Example: 422

  - `errors` (array)

  - `errors.appName` (string)
    Application name
    Example: loadtracking-api

  - `errors.dateTime` (string)
    When the error occurred
    Example: 2024-05-24T19:50:18.053Z

  - `errors.message` (string)
    Human-readable error message
    Example: Invalid eventType. Must be one of: PdvRequestCompleted

  - `errors.keyword` (string)
    Error type keyword
    Example: enum

  - `errors.params` (object)
    Additional error parameters

  - `errors.params.field` (string)
    Example: eventType

  - `errors.params.allowedValues` (array)
    Example: ["PdvRequestCompleted"]