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

# Get Webhooks

> With this endpoint, you can retrieve all the webhooks you’ve configured for your account. The response provides detailed information about each webhook, allowing you to verify their setup and ensure they’re active and correctly configured.

## Request

| Field | **Type** | Required | Description |
| --- | --- | --- | --- |
| Authorization | Header | Yes | The access token is used to authenticate requests to other endpoints. It is valid for 5 minutes. |
| clientID | URL | Yes | Include your assigned **ID** in the URL, obtainable through the **Get infoClient** endpoint. |

## Response

Upon a successful request, the server will respond with an array containing the following details for each registered webhook:

| **Field** | **Description** |
| --- | --- |
| Id | The unique identifier of the webhook. |
| method | The HTTP method used by the webhook (e.g., POST). |
| process | The process the webhook monitors (`ramp`, `compliance` or `wallet_transfer`). |
| status | Indicates whether the webhook is active (true) or inactive (false). |
| url | The destination URL where notifications are sent. |
| userId | The unique identifier of the user associated with the webhook. |

**Note:** Regularly review your webhook configurations to ensure they’re correctly set up and pointing to the right URLs.



## OpenAPI

````yaml /business/openapi.json get /api/webhooks/{clientId}
openapi: 3.1.0
info:
  title: Kravata Business API
  version: '1.0'
  description: >-
    Kravata Business API: on-ramp and off-ramp orders between fiat and
    stablecoins for your own accounts and wallets.
servers:
  - url: https://testapi.kravata.co
    description: Test
  - url: https://apiv2.kravata.co
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Authentication
  - name: Accounts
  - name: Wallets
  - name: Ramp Orders
  - name: Webhooks
paths:
  /api/webhooks/{clientId}:
    get:
      tags:
        - Webhooks
      summary: Get Webhooks
      description: >-
        With this endpoint, you can retrieve all the webhooks you’ve configured
        for your account. The response provides detailed information about each
        webhook, allowing you to verify their setup and ensure they’re active
        and correctly configured.


        ## Request


        | Field | **Type** | Required | Description |

        | --- | --- | --- | --- |

        | Authorization | Header | Yes | The access token is used to
        authenticate requests to other endpoints. It is valid for 5 minutes. |

        | clientID | URL | Yes | Include your assigned **ID** in the URL,
        obtainable through the **Get infoClient** endpoint. |


        ## Response


        Upon a successful request, the server will respond with an array
        containing the following details for each registered webhook:


        | **Field** | **Description** |

        | --- | --- |

        | Id | The unique identifier of the webhook. |

        | method | The HTTP method used by the webhook (e.g., POST). |

        | process | The process the webhook monitors (`ramp`, `compliance` or
        `wallet_transfer`). |

        | status | Indicates whether the webhook is active (true) or inactive
        (false). |

        | url | The destination URL where notifications are sent. |

        | userId | The unique identifier of the user associated with the
        webhook. |


        **Note:** Regularly review your webhook configurations to ensure they’re
        correctly set up and pointing to the right URLs.
      operationId: get-webhooks
      parameters:
        - name: clientId
          in: path
          required: true
          description: ''
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                    method:
                      type: string
                    process:
                      type: string
                    status:
                      type: boolean
                    url:
                      type: string
                    userId:
                      type: string
              examples:
                api-webhooks:
                  summary: api/webhooks
                  value:
                    - id: 48899140-5567-4919-bc26-a0e93018c3ce
                      method: POST
                      process: ramp
                      status: true
                      url: https://your-server.example.com/webhooks/kravata
                      userId: 20ec3cb9-497c-480f-9478-4d64c7b43064
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Access token from POST /api/token (valid 5 minutes).

````