# /webhook

Retrieves webhook configurations for the authenticated partner.
## Behavior
- Without webhook_id: Returns ALL webhooks for the partner (array)
- With webhook_id: Returns a specific webhook configuration (object)

## Authentication
Requires `x-client-id` and `x-secret-key` headers.
## Notes
- Does NOT return the webhook_secret (only available at registration time or after rotation)
- Returns empty array if partner has no webhooks registered
- Returns 404 if specified webhook_id not found

## Common errors
- `401` Invalid credentials
- `404` Webhook not found (when webhook_id specified)
- `500` Internal error

Endpoint: GET /webhook
Version: 1.0.0

## Query parameters:

  - `webhook_id` (string)
    UUID v4 identifier of a specific webhook to retrieve. If omitted, all webhooks for the partner are returned.

Error codes: type=400002

## Header parameters:

  - `x-client-id` (string, required)
    Unique identifier assigned to the integrating client.

Error codes: required=400001, type=400002, minLength=400003, maxLength=400004

  - `x-secret-key` (string, required)
    Secret authentication key associated with the client.

Error codes: required=400001, type=400002, minLength=400003, maxLength=400004

## Response 200 fields (application/json):

  - `status` (string)
    success

  - `data` (string)
    Array of webhooks (no param) or single webhook object (with param)

## Response 401 fields (application/json):

  - `errors` (array)
    Error catalog for 401 (click to expand)CodeDescription401000Invalid credentials

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

## Response 404 fields (application/json):

  - `errors` (array)
    Error catalog for 404 (click to expand)CodeDescription404000Webhook not found

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)

## Response 500 fields (application/json):

  - `errors` (array)
    Error catalog for 500 (click to expand)CodeDescription500000Internal server error

  - `errors.status` (string)

  - `errors.code` (number)

  - `errors.message` (string)