Skip to main content
GET
/
v1
/
webhooks
/
endpoints
List webhook endpoints
curl --request GET \
  --url https://api.example.com/v1/webhooks/endpoints
[
  {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "name": "My Backend",
    "url": "https://api.example.com/webhooks/truthlock",
    "status": "active",
    "event_filters": ["attestation.*", "verification.completed"],
    "created_at": "2026-03-25T12:00:00Z",
    "updated_at": "2026-03-25T12:00:00Z"
  },
  {
    "id": "770e8400-e29b-41d4-a716-446655440002",
    "name": "Analytics Service",
    "url": "https://analytics.example.com/hooks",
    "status": "active",
    "event_filters": ["billing.*"],
    "created_at": "2026-03-20T09:30:00Z",
    "updated_at": "2026-03-20T09:30:00Z"
  }
]
Returns all webhook endpoints for the authenticated tenant, sorted by creation time (newest first). The endpoint secret is not included in list responses — it is only returned once when the endpoint is created.

​
Response fields

FieldTypeDescription
iduuidUnique identifier for the endpoint
namestringHuman-readable name you assigned when creating the endpoint
urlstringThe HTTPS URL that receives webhook deliveries
statusstringCurrent endpoint status: active or disabled
event_filtersstring[]Event types or wildcard patterns the endpoint subscribes to
created_atstringISO 8601 timestamp when the endpoint was created
updated_atstringISO 8601 timestamp of the last modification

​
Responses

[
  {
    "id": "660e8400-e29b-41d4-a716-446655440001",
    "name": "My Backend",
    "url": "https://api.example.com/webhooks/truthlock",
    "status": "active",
    "event_filters": ["attestation.*", "verification.completed"],
    "created_at": "2026-03-25T12:00:00Z",
    "updated_at": "2026-03-25T12:00:00Z"
  },
  {
    "id": "770e8400-e29b-41d4-a716-446655440002",
    "name": "Analytics Service",
    "url": "https://analytics.example.com/hooks",
    "status": "active",
    "event_filters": ["billing.*"],
    "created_at": "2026-03-20T09:30:00Z",
    "updated_at": "2026-03-20T09:30:00Z"
  }
]