# Get a webhook

`GET /client_api/v2/webhooks/{id}`

## Parameters

- `id` (integer, required): The webhook's id.

## Returns

Returns the webhook.

- `webhook` (object, required): The webhook.
  - `events` (array of string, required): The events to send. `shipment.updated.status` fires when a shipment's status changes.
`shipment.updated.waybill` fires when a shipment gets its waybill.
 Possible enum values: `shipment.updated.status`, `shipment.updated.waybill`.
  - `id` (integer, required): The webhook's id.
  - `status` (enum, required): `failing` when deliveries to the URL keep failing. Possible enum values: `active`, `failing`.
  - `target_url` (string, required): The http or https URL we send events to.
  - `token` (string, required): A secret we send with every event, so your system can tell the event came from us.

## Errors

- `401 Unauthorized`: The token is missing, expired or invalid. Sign in again.

## Example request (curl)

```bash
curl -X GET "https://sandbox-api.vatit-stream.com/client_api/v2/webhooks/1" \
  -H "Authorization: Bearer $API_TOKEN"
```

## Example response (200)

```json
{
  "webhook": {
    "events": [
      "shipment.updated.status",
      "shipment.updated.waybill"
    ],
    "id": 1,
    "status": "active",
    "target_url": "https://hooks.globaltradecorp.example/stream",
    "token": "q7Vt2mX9pL4sKe8RzW1nYg"
  }
}
```