Get delivery metrics time series
Returns time series of delivery stats per destination. Real-time (<=48h) queries raw delivery_attempts table; historical (>48h) queries pre-aggregated metrics.
GET
/metrics/deliveries
Returns time series of delivery stats per destination. Real-time (<=48h) queries raw delivery_attempts table; historical (>48h) queries pre-aggregated metrics.
Authentication
API Key (header: X-API-Key) API Key (cookie: better-auth.session_token)
Query Parameters
destination_id
string
optional
query
after
string
optional
query
before
string
optional
query
granularity
string
optional
query
Responses
200
Delivery metrics time series
application/jsonseries
object[]
REQUIRED
Array of:
granularity
string
REQUIRED
401
Unauthorized
curl -X GET 'https://hookstream.io/v1/metrics/deliveries' \ -H 'Authorization: Bearer YOUR_API_TOKEN'
const response = await fetch('https://hookstream.io/v1/metrics/deliveries', { 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/metrics/deliveries', headers=headers)print(response.json())
package mainimport ( "fmt" "io" "net/http")func main() { req, _ := http.NewRequest("GET", "https://hookstream.io/v1/metrics/deliveries", 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
{ "series": [ "<object>" ], "granularity": "<string>"}
API Playground
Try this endpoint
GET
/metrics/deliveries