# Get a Webhook

**GET** `/webhooks/{webhookId}`

Base URL: `https://api.uat.triple-a.io/api/fiat-payout/v1`

This endpoint allows API users to retrieve a webhook by its id.

## Authorization

- oauth2 (http, bearer)

## Path parameters

- `webhookId` (string, required)

## Responses

### 200

OK

- `id` (string<uuid>)
  Webhook Identifier
- `external_id` (string, required)
  A unique id specified by API caller to avoid duplication API request
- `event_type` ("document_update" | "sender_update" | "transfer_update" | "payment_update" | "entity_anonymisation_event", required)
  Specify which event this webhook URL will handle.
- `notification_url` (string<uri>, required)
  The URL to which event notification data will be `POST`ed.
- `public_key` (string)
  The URL to which event notification data will be `POST`ed.
- `headers` (object)
  Headers to be included in the notification request.
  - `key` (string)
    Header name
  - `value` (string)
    Header value

Example:

```json
{
  "id": "00000000-0000-0000-0000-000000000000",
  "external_id": "string",
  "event_type": "document_update",
  "notification_url": "string",
  "public_key": "string",
  "headers": {
    "key": "content-type",
    "value": "application/json"
  }
}
```

### 400

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```

### 404

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```

### 500

Error defines errors may be returned from the system.

- `message` (string)
- `errors` (object[])
  - `errorCode` (string)
  - `message` (string)

Example:

```json
{
  "message": "string",
  "errors": [
    {
      "errorCode": "string",
      "message": "string"
    }
  ]
}
```