---
title: "Lists all configured SIP hooks."
method: GET
path: "/sip/hooks"
tags: ["sip"]
---

# Lists all configured SIP hooks.

`GET /sip/hooks`

Returns the current list of SIP hooks from runtime state.
This endpoint requires authentication if `AUTH_REQUIRED=true`.

# Returns
* `200 OK` - List of SIP hooks
* `500 Internal Server Error` - If reading the cache fails

## Response `200`

List of SIP hooks

- SipHooksResponse — Response body for SIP hooks operations.
  - `hooks` SipHookEntry[], required — List of all configured SIP hooks
    - `auth_id` string, required — Tenant identifier for this hook (written to LiveKit room metadata). Required when AUTH_REQUIRED=true; may be empty when AUTH_REQUIRED=false. When empty, room metadata updates are skipped.
    - `host` string, required — Host pattern for matching SIP domains (case-insensitive)
    - `url` string, required — HTTPS URL to forward webhook events to

## Other responses

- `500` — Failed to read hooks cache

## Changes

- **2026-02-08** `0df166d28191` — 1 info
  - the endpoint scheme security `auth` was added to the API
- **2026-01-07** `3a996c4eb1fc` — 1 info
  - added the required property `hooks/items/auth_id` to the response with the `200` status
- **2025-11-26** `f24787a34cc4` — 1 info
  - endpoint added
- **2025-11-12** `d85b83f25aea` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/saynaai/apis/sayna-api/changes/sip/hooks/get.md)

---

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