List sources
List all sources for an organization, optionally filtered by status.
GET
/sources
List all sources for an organization, optionally filtered by status.
Authentication
API Key (header: X-API-Key) API Key (cookie: better-auth.session_token)
Query Parameters
org_id
string
optional
query
Organization ID
env_id
string
optional
query
Environment ID
status
string
optional
query
Filter by status
Responses
200
List of sources
application/jsonsources
object | null[]
REQUIRED
Array of:
id
string
REQUIRED
org_id
string
REQUIRED
env_id
string
REQUIRED
slug
string
REQUIRED
name
string
REQUIRED
description
string | null
REQUIRED
template
string | null
REQUIRED
verification_enabled
integer
REQUIRED
verification_type
string | null
REQUIRED
verification_secret
string | null
REQUIRED
verification_header
string | null
REQUIRED
verification_config
string | null
REQUIRED
dedup_enabled
integer
REQUIRED
dedup_strategy
string | null
REQUIRED
dedup_field
string | null
REQUIRED
dedup_window_seconds
integer
REQUIRED
ip_allowlist
string | null
REQUIRED
ip_denylist
string | null
REQUIRED
status
string
REQUIRED
event_count
integer
REQUIRED
last_event_at
string | null
REQUIRED
created_at
string
REQUIRED
updated_at
string
REQUIRED
is_ephemeral
integer
REQUIRED
expires_at
string | null
REQUIRED
request_limit
integer | null
REQUIRED
type
string
REQUIRED
source_config
string | null
REQUIRED
schema_validation_enabled
integer
REQUIRED
json_schema
string | null
REQUIRED
schema_action
string | null
REQUIRED
401
Unauthorized
curl -X GET 'https://hookstream.io/v1/sources' \ -H 'Authorization: Bearer YOUR_API_TOKEN'
const response = await fetch('https://hookstream.io/v1/sources', { method: 'GET', headers: { "Authorization": "Bearer YOUR_API_TOKEN" }});const data = await response.json();console.log(data);
import requestsheaders = { 'Authorization': 'Bearer YOUR_API_TOKEN'}response = requests.get('https://hookstream.io/v1/sources', headers=headers)print(response.json())
package mainimport ( "fmt" "io" "net/http")func main() { req, _ := http.NewRequest("GET", "https://hookstream.io/v1/sources", nil) req.Header.Set("Authorization", "Bearer YOUR_API_TOKEN") resp, _ := http.DefaultClient.Do(req) defer resp.Body.Close() result, _ := io.ReadAll(resp.Body) fmt.Println(string(result))}
200
Response
{ "sources": [ { "id": "<string>", "org_id": "<string>", "env_id": "<string>", "slug": "<string>", "name": "<string>", "description": "<string>", "template": "<string>", "verification_enabled": 123, "verification_type": "<string>", "verification_secret": "<string>", "verification_header": "<string>", "verification_config": "<string>", "dedup_enabled": 123, "dedup_strategy": "<string>", "dedup_field": "<string>", "dedup_window_seconds": 123, "ip_allowlist": "<string>", "ip_denylist": "<string>", "status": "<string>", "event_count": 123, "last_event_at": "<string>", "created_at": "<string>", "updated_at": "<string>", "is_ephemeral": 123, "expires_at": "<string>", "request_limit": 123, "type": "<string>", "source_config": "<string>", "schema_validation_enabled": 123, "json_schema": "<string>", "schema_action": "<string>" } ]}
API Playground
Try this endpoint
GET
/sources