> ## Documentation Index > Fetch the complete documentation index at: https://docs.context.dev/llms.txt > Use this file to discover all available pages before exploring further. # List Webhook Deliveries > List your batch or monitor webhook deliveries, newest first. 0 Credits Set `type` to `batch` or `monitor` to choose which deliveries to list. Use a delivery's `id` to [retrieve its current status](/api-reference/webhooks/retrieve), [inspect its attempts](/api-reference/webhooks/attempts), or [retry delivery](/api-reference/webhooks/retry). ## OpenAPI ````yaml POST /webhooks/deliveries openapi: 3.1.0 info: title: Context.dev API description: API for retrieving context data from any website version: 1.0.0 servers: - url: https://api.context.dev/v1 security: [] tags: - name: Webhooks description: Inspect and retry webhook deliveries. These endpoints cost no credits. - name: Batch description: Scrape many pages or crawl a site asynchronously. - name: Monitors description: >- Monitor pages, sitemaps, and extracted website data for exact or semantic changes. Webhook payloads are documented by the MonitorsChangeDetectedWebhookPayload and MonitorsRunCompletedWebhookPayload schemas. - name: News description: >- Search live first-party RSS and free historical news data by company identity. paths: /webhooks/deliveries: post: tags: - Webhooks summary: List webhook deliveries description: List your batch or monitor webhook deliveries, newest first. operationId: listWebhookDeliveries requestBody: required: true content: application/json: schema: oneOf: - type: object properties: type: type: string enum: - batch description: Delivery source. batch_id: type: string minLength: 1 maxLength: 200 pattern: ^[\w-]+$ description: Filter by batch ID. status: type: string enum: - pending - delivering - retrying - delivered - failed - cancelled description: Filter by delivery status. created_after: type: string format: date-time description: >- Only include events created after this ISO 8601 timestamp. example: '2026-09-01T00:00:00Z' limit: type: integer minimum: 1 maximum: 100 default: 25 description: Number of deliveries to return. cursor: type: string pattern: ^whd_[a-f0-9]{32}$ description: The next_cursor from the previous response. tags: $ref: '#/components/schemas/RequestTags' required: - type additionalProperties: false title: By Batch - type: object properties: type: type: string enum: - monitor description: Delivery source. monitor_id: type: string minLength: 1 maxLength: 200 pattern: ^[\w-]+$ description: Filter by monitor ID. run_id: type: string minLength: 1 maxLength: 200 pattern: ^[\w-]+$ description: Filter by monitor run ID. status: type: string enum: - pending - delivering - retrying - delivered - failed - cancelled description: Filter by delivery status. created_after: type: string format: date-time description: >- Only include events created after this ISO 8601 timestamp. example: '2026-09-01T00:00:00Z' limit: type: integer minimum: 1 maximum: 100 default: 25 description: Number of deliveries to return. cursor: type: string pattern: ^whd_[a-f0-9]{32}$ description: The next_cursor from the previous response. tags: $ref: '#/components/schemas/RequestTags' required: - type additionalProperties: false title: By Monitor discriminator: propertyName: type examples: batch: summary: List failed batch deliveries value: type: batch status: failed limit: 25 monitor: summary: List deliveries for a monitor run value: type: monitor monitor_id: mon_123 run_id: run_123 recent_monitor_failures: summary: List recent monitor delivery failures value: type: monitor status: failed created_after: '2026-09-01T00:00:00Z' limit: 100 responses: '200': description: A page of webhook deliveries headers: X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: $ref: '#/components/schemas/ListWebhookDeliveriesResponse' '400': $ref: '#/components/responses/BadRequest' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' '429': description: Rate limit exceeded (600 requests per minute per organization). headers: X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '500': description: Webhook service is temporarily unavailable. headers: X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: RequestTags: type: array items: type: string minLength: 1 maxLength: 50 maxItems: 20 description: >- Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters. example: - production - team-alpha ListWebhookDeliveriesResponse: type: object properties: data: type: array items: $ref: '#/components/schemas/WebhookDeliverySummary' description: Webhook deliveries. has_more: type: boolean description: Whether more deliveries are available. next_cursor: type: - string - 'null' description: Next page cursor, or null on the last page. key_metadata: $ref: '#/components/schemas/KeyMetadata' required: - data - has_more - next_cursor ErrorResponse: type: object properties: message: type: string description: Error message error_code: type: string enum: - INTERNAL_ERROR - VALID - NOT_FOUND - FORBIDDEN - USAGE_EXCEEDED - RATE_LIMITED - UNAUTHORIZED - DISABLED - PAID_PLAN_REQUIRED - INSUFFICIENT_PERMISSIONS - TIMEOUT_EXCEEDS_MAXIMUM - WEBSITE_ACCESS_ERROR - WEBSITE_BLOCKED - WEBSITE_NOT_FOUND - PDF_SKIPPED - PDF_IMAGES_ONLY - EXTERNAL_PROVIDER_ERROR - INPUT_VALIDATION_ERROR - ZDR_NOT_SUPPORTED - ZDR_NOT_ENABLED - FREE_EMAIL_DETECTED - DISPOSABLE_EMAIL_DETECTED - REQUEST_TIMEOUT - COLD_DOMAIN_TIMEOUT_TOO_LOW - UNSUPPORTED_CONTENT - CONTENT_TOO_LARGE - MONITOR_PAUSED - MONITOR_NO_WEBHOOK - COLLECTION_PAUSED - MONITOR_LIMIT_EXCEEDED - SEARCH_UNAVAILABLE - BATCH_LIMIT_EXCEEDED - BATCH_NOT_CANCELLABLE - BATCH_NOT_COMPLETED - IDEMPOTENCY_KEY_CONFLICT - DELIVERY_IN_PROGRESS - DELIVERY_ALREADY_DELIVERED - DELIVERY_EXPIRED - DELIVERY_CANCELLED description: Error code indicating the type of error key_metadata: $ref: '#/components/schemas/KeyMetadata' WebhookDeliverySummary: type: object properties: id: type: string description: Delivery ID. event: type: string enum: - batch.completed - batch.failed - batch.cancelled - change.detected - run.completed description: Webhook event type. source: oneOf: - type: object properties: type: type: string enum: - batch description: Delivery source. batch_id: type: string description: Batch ID. required: - type - batch_id title: Batch - type: object properties: type: type: string enum: - monitor description: Delivery source. monitor_id: type: string description: Monitor ID. run_id: type: string description: Monitor run ID. required: - type - monitor_id - run_id title: Monitor description: Batch or monitor run that produced the event. url: type: string format: uri description: Webhook destination URL. status: type: string enum: - pending - delivering - retrying - delivered - failed - cancelled description: Current delivery status. created_at: type: string format: date-time description: Event creation time. retry_expires_at: type: string format: date-time description: Manual retry deadline, seven days after event creation. delivered_at: type: - string - 'null' format: date-time description: Last successful delivery time, or null if never delivered. next_attempt_at: type: - string - 'null' format: date-time description: Next scheduled attempt, or null if none. last_error: type: - object - 'null' properties: code: type: string description: Error code. message: type: string description: Error details. required: - code - message description: Latest delivery error, or null if none. required: - id - event - source - url - status - created_at - retry_expires_at - delivered_at - next_attempt_at - last_error KeyMetadata: type: object properties: credits_consumed: type: integer description: Credits used by this request. credits_remaining: type: integer description: Credits remaining for your organization. required: - credits_consumed - credits_remaining description: Credit usage, included whenever a valid API key is provided. headers: RateLimitLimit: description: Maximum requests per minute. schema: type: integer minimum: 1 RateLimitRemaining: description: Requests remaining in the current minute. schema: type: integer minimum: 0 RateLimitReset: description: Unix timestamp in seconds when the rate limit resets. schema: type: integer responses: BadRequest: description: Bad request content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' headers: X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' Unauthorized: description: Unauthorized headers: X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' NotFound: description: Not found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' headers: X-RateLimit-Limit: $ref: '#/components/headers/RateLimitLimit' X-RateLimit-Remaining: $ref: '#/components/headers/RateLimitRemaining' X-RateLimit-Reset: $ref: '#/components/headers/RateLimitReset' ````