---
title: "Get Webhook"
method: GET
path: "/api/v1/webhooks/{id}"
tags: ["Webhooks"]
---

# Get Webhook

`GET /api/v1/webhooks/{id}`

## Request

- Base URL: `https://api.fordefi.com`
- URL: `https://api.fordefi.com/api/v1/webhooks/{id}`
- Auth: HTTP bearer

Get a single webhook in an organization.

## Path parameters

- `id` string, uuid, required: ID of the webhook to get.

## Response `200`

Successful Response

- GetWebhookResponse: Represents a webhook in the Fordefi platform
  - `id` string, uuid, required: The unique identifier of the object in the Fordefi platform.
  - `created_at` string, date-time, required: The date and time when the object was created.
  - `modified_at` string, date-time, required: The date and time when the object was last modified. Any change to any field of the resource is considered a modification.
  - `name` string, required: The name of the webhook.
  - `created_by` union, required: Represents a reference to a user in the Fordefi platform
    - PersonRef
      - `id` string, uuid, required: The unique identifier of the user in the Fordefi platform.
      - `user_type` 'person', required: The type of user. Can be a person, or (in programmatic scenarios) an API user or API Signer.
      - `name` string: The name of the user.
      - `email` string, required: The email of the user.
      - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'reset_device_pending_code_generation' | 'reset_device_pending_activation' | 'pending_approval' | 'deleted', required
      - `role` 'admin' | 'trader' | 'viewer', required
    - ApiUserRef
      - `id` string, uuid, required: The unique identifier of the user in the Fordefi platform.
      - `user_type` 'api_user', required: The type of the user.
      - `name` string, required: The name of the user.
      - `state` 'active' | 'pending_approval' | 'onboarding_pending_activation' | 'deleted', required: The state of the user. Is one of: <ul><li>`active`: The user can perform all actions in the Fordefi platform.<li>`pending_approval`: The user creation is awaiting admin-quorum approval.<li>`onboarding_pending_activation`: The user is approved and awaiting token activation.<li>`deleted`: The user has been deleted.</ul>
      - `role` 'admin' | 'trader' | 'viewer', required
      - `activated_at` string, date-time: When the api user was activated and its access token was issued.
    - ApiSignerRef
      - `id` string, uuid, required: The unique identifier of the user in the Fordefi platform.
      - `user_type` 'api_signer', required: The type of the user.
      - `name` string, required: The name of the user.
      - `state` 'active' | 'onboarding_pending_code_generation' | 'onboarding_pending_activation' | 'deleted', required: The state of the user.
    - EndUserRef
      - `id` string, uuid, required: The unique identifier of the user in the Fordefi platform.
      - `user_type` 'end_user', required: The type of the user.
      - `external_id` string, required: External id of the user.
      - `state` 'active' | 'deleted', required: The state of the user.
    - SystemUserRef
      - `id` string, uuid, required: The unique identifier of the user in the Fordefi platform.
      - `user_type` 'system', required: The type of the user.
      - `name` string, required: The name is Fordefi CARE
  - `events` WebhookEventType[], required: The events that will trigger notifications for this subscription.
  - `url` string, uri, required: The URL of the webhook endpoint.
  - `last_successful_call_at` string, date-time, required: The last successful call time to the webhook.
  - `first_failed_call_at` string, date-time, required: The first failed call time to the webhook.
  - `state` 'active' | 'suspended', required
  - `is_retries_suspended` boolean, required: Whether retries suspended for this webhook.
  - `suspension_reason` SuspensionReason
    - `title` string, required
    - `detail` string, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized User
- `403`: Forbidden User
- `404`: Not Found
- `408`: Request Timeout
- `422`: Validation Error
- `429`: Rate Limit Exceeded
- `500`: Unexpected Error

## Changes

- **2026-10-04** `2070400d3da0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/fordefi/apis/fordefi-api/changes/api/v1/webhooks/:id/get.md)

---

[API](https://skmtc.dev/fordefi/apis/fordefi-api.md) - [All operations](https://skmtc.dev/fordefi/apis/fordefi-api/llms.txt) - [OpenAPI document](https://skmtc.dev/fordefi/apis/fordefi-api/revisions/6072439d9e20?raw)