---
title: "Get all webhooks"
method: GET
path: "/webhooks"
tags: ["Webhooks"]
---

# Get all webhooks

`GET /webhooks`

Gets the active webhook subscriptions that your app has created for the user.

For more details about webhooks see:
  - [📖 Webhooks reference](/docs/reference-webhooks)
  - [📖 Webhooks events](/reference-webhooks#token)

## Headers

- `X-Akahu-Id` string, required

## Response `200`

Successful response.

- object
  - `success` boolean
  - `items` Webhook[]
    - `_id` string — Unique Akahu webhook identifier.
    - `created_at` string, date-time — ISO 8601 formatted timestamp that the webhook was created.
    - `updated_at` string, date-time — ISO 8601 formatted timestamp that the webhook was last updated.
    - `last_called_at` string, date-time — ISO 8601 formatted timestamp of the last time your webhook endpoint was sent a webhook event.
    - `state` string — Stored state upon creating a webhook and is made available on the webhook event allowing you to verify the event. Can be used to store a unique identifier related to your end user allowing you to determine on an arrival of a webhook event which user of your application needs to be updated or notified.
    - `url` string, uri — Endpoint to send registered webhook events to.

## Other responses

- `400` — Your request was malformed or otherwise unacceptable. More details are provided under the `message` key in the response.
- `401` — You are not authorised to access this content.
- `403` — You are not allowed to access this content.
- `500` — An internal error has prevented us from processing the request. More detail may be supplied in the `message` key.

---

[API](https://skmtc.dev/akahu/apis/akahu-enduring-api.md) · [All operations](https://skmtc.dev/akahu/apis/akahu-enduring-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/akahu/akahu-enduring-api/revisions/b2de9915920d/schema)