Get pull event metrics

GET

/v1/pull-metrics

• Production

Retrieve aggregated metrics for pull events including counts of stored and delivered events.

Authorizations

• BearerAuth

Parameters

Query Parameters

window

string

default: 24h

Allowed values: 1h 24h 7d 30d

Time window for aggregation

pull_endpoint_id

string format: uuid

Filter metrics by specific pull endpoint

Responses

200

Pull 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

avg_delivery_time_ms

Average total delivery time (created_at to delivered_at) for succeeded messages

integer

avg_queue_wait_ms

Average queue wait time (created_at to first_attempt_at) for attempted messages

integer

meta

object

request_id

Unique identifier for this request (useful for support)

string

Example

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"
  }
}