Webhooks
List Webhooks
List the webhooks your API key owns
GET
/
api
/
v1
/
webhooks
curl --request GET \
--url https://anivahealth.com/api/v1/webhooks \
--header 'x-api-key: YOUR_API_KEY'
[
{
"id": "4a6c8e0f-2b4d-4f6a-8c0e-2a4c6e8f0b1d",
"url": "https://partner.example.com/webhooks/aniva",
"description": "Production",
"enabled_events": [
"appointment.confirmed",
"appointment.results.completed",
"home_kit_order.results.completed"
],
"alert_emails": ["ops@partner.example.com"],
"status": "enabled",
"disabled_at": null,
"disabled_reason": null,
"failing_since": null,
"previous_secret_expires_at": null,
"created_at": "2026-10-15T08:00:00.000Z",
"updated_at": "2026-10-15T08:00:00.000Z"
}
]
List the webhooks your API key owns, oldest first. The response never contains a signing
secret.
Requires the
webhooks_manage scope.Request
This endpoint takes no parameters.Response
On success, the API returns200 OK with an array of webhook objects.
string
required
Webhook identifier (UUID).
string
required
The HTTPS URL Aniva posts events to.
string
Free text for your own reference. May be
null.string[]
required
Event types this webhook receives.
* means every type.string[]
required
Addresses Aniva emails when deliveries keep failing.
string
required
enabled or disabled.string
ISO 8601 UTC instant the webhook was disabled.
null while enabled.string
Why the webhook was disabled. See Failure notices.
null
while enabled.string
ISO 8601 UTC instant the current failure streak started.
null when the last delivery succeeded.string
ISO 8601 UTC instant the previous secret stops signing.
null when no rotation is in progress.string
required
ISO 8601 UTC instant the webhook was created.
string
required
ISO 8601 UTC instant of the last change.
Error responses
| Status | Description |
|---|---|
401 | Invalid API key. |
403 | No API key, or an API key without the webhooks_manage scope. |
500 | Internal server error. |
curl --request GET \
--url https://anivahealth.com/api/v1/webhooks \
--header 'x-api-key: YOUR_API_KEY'
[
{
"id": "4a6c8e0f-2b4d-4f6a-8c0e-2a4c6e8f0b1d",
"url": "https://partner.example.com/webhooks/aniva",
"description": "Production",
"enabled_events": [
"appointment.confirmed",
"appointment.results.completed",
"home_kit_order.results.completed"
],
"alert_emails": ["ops@partner.example.com"],
"status": "enabled",
"disabled_at": null,
"disabled_reason": null,
"failing_since": null,
"previous_secret_expires_at": null,
"created_at": "2026-10-15T08:00:00.000Z",
"updated_at": "2026-10-15T08:00:00.000Z"
}
]
⌘I
curl --request GET \
--url https://anivahealth.com/api/v1/webhooks \
--header 'x-api-key: YOUR_API_KEY'
[
{
"id": "4a6c8e0f-2b4d-4f6a-8c0e-2a4c6e8f0b1d",
"url": "https://partner.example.com/webhooks/aniva",
"description": "Production",
"enabled_events": [
"appointment.confirmed",
"appointment.results.completed",
"home_kit_order.results.completed"
],
"alert_emails": ["ops@partner.example.com"],
"status": "enabled",
"disabled_at": null,
"disabled_reason": null,
"failing_since": null,
"previous_secret_expires_at": null,
"created_at": "2026-10-15T08:00:00.000Z",
"updated_at": "2026-10-15T08:00:00.000Z"
}
]