Retrieve a webhook event

GET

https://api.runledger.co/v1/webhook_events/:webhook_event_id

GET

/v1/webhook_events/:webhook_event_id

curl https://api.runledger.co/v1/webhook_events/webhook_event_id \
     -H "Authorization: Bearer <api_key>"

{
  "id": "whe_0pL3kJ6hGf",
  "object": "string",
  "type": "customer.created",
  "api_version": "2026-10-18",
  "related_object": {
    "id": "oc_2xK9cL4vRt",
    "object": "outcome_charge",
    "url": "/v1/outcome_charges/oc_2xK9cL4vRt"
  },
  "livemode": true,
  "created_at": "2024-01-15T09:30:00Z",
  "reason": {
    "type": "request",
    "request_id": "string",
    "idempotency_key": "string",
    "notification_rule": "string"
  },
  "context": {
    "customer": "string",
    "member_id": "string",
    "team_id": "string",
    "pool": "string",
    "allowance": "string",
    "spend_limit": "string",
    "threshold": "0.8",
    "window_start": "2024-01-15T09:30:00Z",
    "resets_at": "2024-01-15T09:30:00Z"
  },
  "delivery_status": "pending",
  "deliveries": [
    {
      "webhook_endpoint": "string",
      "attempted_at": "2024-01-15T09:30:00Z",
      "succeeded": true,
      "status_code": 1,
      "duration_ms": 1
    }
  ]
}

Includes the last 10 delivery attempts to each endpoint.

Authentication

AuthorizationBearer

A secret key (rl_sk_test_..., rl_sk_live_...) or a restricted key with limited scopes (rl_rk_test_..., rl_rk_live_...). A restricted key can carry agent: true and an expires_at, and is what a coding agent should hold. Keys end in a checksum so secret scanners can recognize them. People create, roll and revoke keys in the dashboard; GET /v1/api_keys lists them, masked.

Path parameters

webhook_event_idstringRequired

The webhook event ID (whe_...).

Response

The webhook event.

idstring

object"webhook_event"

typeenum

New types may be added. Subscribe only to the ones you handle.

api_versionstring

related_objectobject

livemodeboolean

created_atdatetime

reasonobjectOptional

What caused the event.

contextobjectOptional

The fields that identify what a limit, window or purchase event is about, for events that don’t name a stored object of their own. Fetch related_object for the current state.

delivery_statusenumOptional

pending: still being sent or retried. succeeded: every subscribed endpoint acknowledged it. failed: retries ran out for at least one endpoint.

Allowed values:

deliverieslist of objectsOptional

Retrieve only. The last 10 attempts per endpoint.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

429

Too Many Requests Error

500

Internal Server Error