Get delivery metrics

GET

/v1/metrics

• Production

Retrieve aggregated metrics for webhook deliveries including success rates, latency, and retry counts.

Authorizations

• BearerAuth

Parameters

Query Parameters

window

string

default: 24h

Allowed values: 1h 24h 7d 30d

Time window for aggregation

Example

24h

endpoint_id

string

/^ep_[a-f0-9]{32}$/

Filter metrics by specific endpoint

Example

ep_550e8400e29b41d4a716446655440000

Responses

200

Metrics retrieved successfully

object

data

object

window

Time window for these metrics

string

Allowed values: 1h 24h 7d 30d

Example

24h

total_messages

Total number of messages in the window

integer

Example

10000

succeeded

Number of successfully delivered messages

integer

Example

9950

failed

Number of permanently failed messages

integer

Example

50

retries

Total number of retry attempts

integer

Example

150

success_rate

Ratio of succeeded messages to total messages

number format: float

Example

0.995

avg_latency_ms

Average delivery latency in milliseconds

integer

Example

185

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

req_xyz123

Example

{
  "data": {
    "window": "24h",
    "total_messages": 10000,
    "succeeded": 9950,
    "failed": 50,
    "retries": 150,
    "success_rate": 0.995,
    "avg_latency_ms": 185
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}

400

Invalid request

object

error

object

code

Machine-readable error code

string

Example

INVALID_REQUEST

message

Human-readable error message

string

Example

endpoint must be a valid HTTPS URL

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

req_xyz123

Examples

Endpoint not found

{
  "error": {
    "code": "ENDPOINT_NOT_FOUND",
    "message": "endpoint not found"
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}

Invalid endpoint ID format

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "endpoint_id must be in format ep_xxx"
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}

Invalid payload

{
  "error": {
    "code": "INVALID_REQUEST",
    "message": "payload must be valid JSON"
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}

Invalid headers

{
  "error": {
    "code": "INVALID_HEADERS",
    "message": "header 'Host' is forbidden and cannot be overridden"
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}

401

Unauthorized - Invalid or missing API key

object

error

object

code

Machine-readable error code

string

Example

INVALID_REQUEST

message

Human-readable error message

string

Example

endpoint must be a valid HTTPS URL

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

req_xyz123

Example

{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid or missing API key"
  },
  "meta": {
    "request_id": "req_xyz123"
  }
}