Skip to main content
GET
/
webhook-endpoints
curl https://api.bota.dev/v1/webhook-endpoints \
  -H "Authorization: Bearer sk_live_..."

{
  "data": [
    {
      "id": "we_abc123",
      "url": "https://example.com/webhooks/bota",
      "events": ["recording.uploaded", "transcription.completed"],
      "description": "Production webhook",
      "status": "enabled",
      "metadata": null,
      "created_at": "2025-01-15T10:30:00Z"
    },
    {
      "id": "we_def456",
      "url": "https://staging.example.com/webhooks",
      "events": ["*"],
      "description": "Staging webhook",
      "status": "disabled",
      "metadata": null,
      "created_at": "2025-01-10T08:00:00Z"
    }
  ],
  "has_more": false
}
Retrieve a paginated list of webhook endpoints configured for your project.
​
limit
integer
default:"25"
Maximum number of items to return (1-100).
​
offset
integer
default:"0"
Number of items to skip.
curl https://api.bota.dev/v1/webhook-endpoints \
  -H "Authorization: Bearer sk_live_..."

{
  "data": [
    {
      "id": "we_abc123",
      "url": "https://example.com/webhooks/bota",
      "events": ["recording.uploaded", "transcription.completed"],
      "description": "Production webhook",
      "status": "enabled",
      "metadata": null,
      "created_at": "2025-01-15T10:30:00Z"
    },
    {
      "id": "we_def456",
      "url": "https://staging.example.com/webhooks",
      "events": ["*"],
      "description": "Staging webhook",
      "status": "disabled",
      "metadata": null,
      "created_at": "2025-01-10T08:00:00Z"
    }
  ],
  "has_more": false
}
The secret field is not included in list responses. It’s only returned when creating a new endpoint or rotating the secret.