# Danh sách webhook > Chỉ dùng endpoint, field, mã lỗi và ví dụ trong trang này. Không thêm API chưa được mô tả ở đây. `GET /v1/webhooks` Lấy các webhook của ứng dụng xác định bởi app_id: URL, trạng thái bật và sự kiện đã đăng ký. ## Giới thiệu API trả các webhook đã thêm cho ứng dụng. Header app_id là UUID dùng để tìm ứng dụng. Header api_key phải là key đang hiệu lực của đúng ứng dụng đó. Key có thể được tạo lại, nên không dùng key để định danh ứng dụng. Key hddt_test_ chỉ gọi Sandbox, key Live chỉ gọi Live. Sandbox và Live là hai danh sách riêng. Danh sách không trả secret dùng để ký thông báo. Secret chỉ có trong phản hồi của API Thêm webhook. Endpoint không dùng token hoá đơn và không trừ hạn mức phát hành. ## Endpoint Gửi GET. Host phải cùng môi trường với API key. Sandbox: https://sandbox.api.hddt.dev. Live: https://api.hddt.dev. Chưa có webhook vẫn trả 200 và data là mảng rỗng. ## Header Gửi App ID để tìm ứng dụng, và API key của đúng ứng dụng đó. Vị trí: header. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `app_id` | string | có | Định danh ứng dụng (UUID). Sao chép App ID trên trang chi tiết ứng dụng (tab Kết nối & bảo mật). | | `api_key` | string | có | API key đang hiệu lực của ứng dụng có app_id ở trên. | ## Ví dụ Lấy webhook sandbox của ứng dụng có App ID đã gửi. cURL: ```bash curl https://sandbox.api.hddt.dev/v1/webhooks \ -H "app_id: $HDDT_APP_ID" \ -H "api_key: $HDDT_API_KEY" ``` ## Phản hồi Khi key hợp lệ, API trả 200. data là mảng webhook của môi trường đó. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `object` | string | có | Luôn là list. | | `data` | array | có | Danh sách webhook. Mảng rỗng khi chưa thêm webhook nào. Xem mục Webhook. | 200 OK: ```json { "object": "list", "data": [ { "id": "wh_8f2a1c9d", "object": "webhook", "url": "https://api.cua-ban.vn/webhooks/hddt", "enabled": true, "events": ["invoice_issued", "tax_authority_response"] } ] } ``` ### Webhook Mỗi phần tử của data là một webhook. Không có trường secret. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `id` | string | có | Định danh webhook, ví dụ wh_8f2a1c9d. | | `object` | string | có | Luôn là webhook. | | `url` | string | có | URL HTTPS nhận thông báo. | | `enabled` | boolean | có | true khi webhook đang nhận thông báo, false khi đang tắt. | | `events` | array of string | có | Các mã trong bảng Sự kiện đang đăng ký. | ### Sự kiện đang đăng ký Mỗi phần tử của events là một mã dưới đây. all nhận mọi sự kiện còn lại. | Mã | Trạng thái | | --- | --- | | `all` | Tất cả | | `template_created` | Tạo mẫu hoá đơn | | `template_quantity_approved` | Duyệt số lượng mẫu hoá đơn | | `template_deleted` | Xoá mẫu hoá đơn | | `invoice_draft_created` | Tạo nháp hoá đơn | | `invoice_issued` | Phát hành hoá đơn | | `invoice_signed` | Ký hoá đơn | | `tax_authority_response` | CQT phản hồi | | `invoice_draft_deleted` | Xoá hoá đơn nháp | ## Mã lỗi Lỗi xác thực trả mã HTTP kèm error.code và error.message. | Trường | Kiểu | Bắt buộc | Mô tả | | --- | --- | --- | --- | | `401 unauthorized` | — | không | Thiếu header app_id hoặc api_key; API key sai, đã thu hồi, hoặc không thuộc app_id. | | `403 forbidden` | — | không | Gửi key của môi trường khác (key hddt_live_ tới host Sandbox, key hddt_test_ tới host Live). | | `404 not_found` | — | không | Không có ứng dụng nào khớp app_id. | | `422 validation_error` | — | không | app_id không phải UUID. | Trang HTML: /docs/webhooks Cập nhật: 10/11/2026