List webhook deliveries

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({type: 'batch', status: 'failed', limit: 25})
};

fetch('https://api.context.dev/v1/webhooks/deliveries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": "<string>",
      "event": "batch.completed",
      "source": {
        "type": "batch",
        "batch_id": "<string>"
      },
      "url": "<string>",
      "status": "pending",
      "created_at": "2023-11-07T05:31:56Z",
      "retry_expires_at": "2023-11-07T05:31:56Z",
      "delivered_at": "2023-11-07T05:31:56Z",
      "next_attempt_at": "2023-11-07T05:31:56Z",
      "last_error": {
        "code": "<string>",
        "message": "<string>"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "<string>",
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "PROFILE_NOT_FOUND",
  "error_data": {
    "is_authenticated": true,
    "should_retry": false,
    "retry_condition": "sufficient_credits",
    "info_url": "https://context.dev/dashboard/subscription",
    "credits_remaining": 1,
    "credits_required": 1,
    "is_credits_required_estimated": true,
    "credits_charged": 1,
    "next_refill_at": "2023-11-07T05:31:56Z",
    "next_refill_credits": 123
  },
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "PROFILE_NOT_FOUND",
  "error_data": {
    "is_authenticated": true,
    "should_retry": false,
    "retry_condition": "sufficient_credits",
    "info_url": "https://context.dev/dashboard/subscription",
    "credits_remaining": 1,
    "credits_required": 1,
    "is_credits_required_estimated": true,
    "credits_charged": 1,
    "next_refill_at": "2023-11-07T05:31:56Z",
    "next_refill_credits": 123
  },
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "PROFILE_NOT_FOUND",
  "error_data": {
    "is_authenticated": true,
    "should_retry": false,
    "retry_condition": "sufficient_credits",
    "info_url": "https://context.dev/dashboard/subscription",
    "credits_remaining": 1,
    "credits_required": 1,
    "is_credits_required_estimated": true,
    "credits_charged": 1,
    "next_refill_at": "2023-11-07T05:31:56Z",
    "next_refill_credits": 123
  },
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "PROFILE_NOT_FOUND",
  "error_data": {
    "is_authenticated": true,
    "should_retry": false,
    "retry_condition": "sufficient_credits",
    "info_url": "https://context.dev/dashboard/subscription",
    "credits_remaining": 1,
    "credits_required": 1,
    "is_credits_required_estimated": true,
    "credits_charged": 1,
    "next_refill_at": "2023-11-07T05:31:56Z",
    "next_refill_credits": 123
  },
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "PROFILE_NOT_FOUND",
  "error_data": {
    "is_authenticated": true,
    "should_retry": false,
    "retry_condition": "sufficient_credits",
    "info_url": "https://context.dev/dashboard/subscription",
    "credits_remaining": 1,
    "credits_required": 1,
    "is_credits_required_estimated": true,
    "credits_charged": 1,
    "next_refill_at": "2023-11-07T05:31:56Z",
    "next_refill_credits": 123
  },
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

POST

webhooks

deliveries

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({type: 'batch', status: 'failed', limit: 25})
};

fetch('https://api.context.dev/v1/webhooks/deliveries', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "data": [
    {
      "id": "<string>",
      "event": "batch.completed",
      "source": {
        "type": "batch",
        "batch_id": "<string>"
      },
      "url": "<string>",
      "status": "pending",
      "created_at": "2023-11-07T05:31:56Z",
      "retry_expires_at": "2023-11-07T05:31:56Z",
      "delivered_at": "2023-11-07T05:31:56Z",
      "next_attempt_at": "2023-11-07T05:31:56Z",
      "last_error": {
        "code": "<string>",
        "message": "<string>"
      }
    }
  ],
  "has_more": true,
  "next_cursor": "<string>",
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "PROFILE_NOT_FOUND",
  "error_data": {
    "is_authenticated": true,
    "should_retry": false,
    "retry_condition": "sufficient_credits",
    "info_url": "https://context.dev/dashboard/subscription",
    "credits_remaining": 1,
    "credits_required": 1,
    "is_credits_required_estimated": true,
    "credits_charged": 1,
    "next_refill_at": "2023-11-07T05:31:56Z",
    "next_refill_credits": 123
  },
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "PROFILE_NOT_FOUND",
  "error_data": {
    "is_authenticated": true,
    "should_retry": false,
    "retry_condition": "sufficient_credits",
    "info_url": "https://context.dev/dashboard/subscription",
    "credits_remaining": 1,
    "credits_required": 1,
    "is_credits_required_estimated": true,
    "credits_charged": 1,
    "next_refill_at": "2023-11-07T05:31:56Z",
    "next_refill_credits": 123
  },
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "PROFILE_NOT_FOUND",
  "error_data": {
    "is_authenticated": true,
    "should_retry": false,
    "retry_condition": "sufficient_credits",
    "info_url": "https://context.dev/dashboard/subscription",
    "credits_remaining": 1,
    "credits_required": 1,
    "is_credits_required_estimated": true,
    "credits_charged": 1,
    "next_refill_at": "2023-11-07T05:31:56Z",
    "next_refill_credits": 123
  },
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "PROFILE_NOT_FOUND",
  "error_data": {
    "is_authenticated": true,
    "should_retry": false,
    "retry_condition": "sufficient_credits",
    "info_url": "https://context.dev/dashboard/subscription",
    "credits_remaining": 1,
    "credits_required": 1,
    "is_credits_required_estimated": true,
    "credits_charged": 1,
    "next_refill_at": "2023-11-07T05:31:56Z",
    "next_refill_credits": 123
  },
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

{
  "request_id": "3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91",
  "message": "<string>",
  "error_code": "PROFILE_NOT_FOUND",
  "error_data": {
    "is_authenticated": true,
    "should_retry": false,
    "retry_condition": "sufficient_credits",
    "info_url": "https://context.dev/dashboard/subscription",
    "credits_remaining": 1,
    "credits_required": 1,
    "is_credits_required_estimated": true,
    "credits_charged": 1,
    "next_refill_at": "2023-11-07T05:31:56Z",
    "next_refill_credits": 123
  },
  "required_permission": "logs:read",
  "key_metadata": {
    "credits_consumed": 123,
    "credits_remaining": 123
  }
}

0 credits See the guide for examples and usage.

Authorizations

Authorization

string

header

required

Send Authorization: Bearer <API_KEY>. Keys have full access unless restricted to scopes.

Body

application/json

By Batch
By Monitor

type

enum<string>

required

Delivery source.

Available options:

batch

batch_id

string

Filter by batch ID.

Required string length: 1 - 200

Pattern: ^[\w-]+$

status

enum<string>

Filter by delivery status.

Available options:

pending,

delivering,

retrying,

delivered,

failed,

cancelled

created_after

string<date-time>

Only include events created after this ISO 8601 timestamp.

Example:

"2026-09-01T00:00:00Z"

limit

integer

default:25

Number of deliveries to return.

Required range: 1 <= x <= 100

cursor

string

The next_cursor from the previous response.

Pattern: ^whd_[a-f0-9]{32}$

Response

A page of webhook deliveries

data

object[]

required

Webhook deliveries.

Show child attributes

has_more

boolean

required

Whether more deliveries are available.

next_cursor

string | null

required

Next page cursor, or null on the last page.

request_id

string<uuid>

required

Unique ID of this request, also in X-Request-Id. Include it when contacting support.

Example:

"3f1c2a6e-8b4d-4c1e-9f0a-2d7b5e6c8a91"

key_metadata

object

Credits this request used and your remaining balance.

Show child attributes

Web Data

Brand Data

Companies

People & News

Batches

Monitors

Webhook Deliveries

Account

Agent Feedback

List webhook deliveries

Authorizations

Body

Response