> For the complete documentation index, see [llms.txt](https://apidocs.arionbanki.is/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidocs.arionbanki.is/business-apis/webhooks-api.md).

# Webhooks API

Subscribe to Open Banking events and receive them as **signed, encrypted webhook callbacks** at your own endpoint. Instead of polling our APIs, you register a callback URL once and we deliver a notification every time a subscribed event occurs. Currently events on the **Claims** domain.

The envelope we deliver is intentionally thin: it carries the event identifiers and HATEOAS `links`, not the business data. Your endpoint uses those links to fetch the full resource from the relevant Business API.

{% hint style="info" %}
A subscription is **created disabled**. It starts delivering real events only after you **verify** your endpoint — the first time we receive a `2xx` from your callback URL, the subscription is activated.
{% endhint %}

### Quick start

Delve straight into how to create a subscription, verify your endpoint and validate the deliveries you receive.

{% content-ref url="/pages/ejuNP6iKqfTjpnYqmTzT" %}
[Webhooks API Quick Start](/business-apis/webhooks-api/webhooks-api-quick-start.md)
{% endcontent-ref %}

### API reference

Look at the endpoints and the data structure or download the OpenAPI yaml file.

{% content-ref url="/pages/1rx2uJXPwAvQoPrSNcpP" %}
[Webhooks API Reference](/business-apis/webhooks-api/webhooks-api-reference.md)
{% endcontent-ref %}