List Endpoints

GET

https://api.captain.dev/v2/webhooks/endpoints

GET

/v2/webhooks/endpoints

import requests
BASE_URL = "https://api.captain.dev"
API_KEY = "your_api_key"
response = requests.get(
    f"{BASE_URL}/v2/webhooks/endpoints",
    headers={"Authorization": f"Bearer {API_KEY}"},
    timeout=30.0,
)
response.raise_for_status()
data = response.json()
for endpoint in data["endpoints"]:
    state = "disabled" if endpoint["disabled"] else "enabled"
    last = endpoint["last_delivery"]
    last_text = f"{last['status']} at {last['at']}" if last else "no deliveries yet"
    print(f"{endpoint['endpoint_id']} {endpoint['url']} ({state}, {last_text})")

{
  "endpoints": [
    {
      "endpoint_id": "whe_3f9a1c7e5b2d4a6c8e0f1a2b",
      "url": "https://example.com/webhooks/captain",
      "description": "Indexing notifications",
      "event_types": [
        "job.completed",
        "job.completed_with_errors",
        "job.failed"
      ],
      "collection_ids": [],
      "sync_ids": [],
      "sources": [],
      "channels": [],
      "include_collection_name": true,
      "disabled": false,
      "disabled_reason": null,
      "last_delivery": {
        "at": "2026-09-23T10:05:13Z",
        "status": "succeeded"
      },
      "created_at": "2026-09-20T16:42:08Z",
      "updated_at": "2026-09-20T16:42:08Z"
    }
  ],
  "limit": 20
}

List the organization's webhook endpoints, with their filters, whether each is disabled and why, and the most recent delivery. Secrets are never included.

Response

Successful Response

endpointslist of objects

limitinteger

The most endpoints the organization may have (20).

Errors

401

Unauthorized Error

429

Too Many Requests Error