> ## Documentation Index > Fetch the complete documentation index at: https://docs.rootly.com/llms.txt > Use this file to discover all available pages before exploring further. # List webhook deliveries > List webhook deliveries for given endpoint ## OpenAPI ````yaml https://rootly-heroku.s3.amazonaws.com/swagger/v1/swagger.json get /v1/webhooks/endpoints/{endpoint_id}/deliveries openapi: 3.0.1 info: title: Rootly API v1 version: v1 license: name: Rootly url: https://rootly.com description: >+ # How to generate an API Key? - **Organization dropdown** > **Organization Settings** > **API Keys** # JSON:API Specification Rootly is using **JSON:API** (https://jsonapi.org) specification: - JSON:API is a specification for how a client should request that resources be fetched or modified, and how a server should respond to those requests. - JSON:API is designed to minimize both the number of requests and the amount of data transmitted between clients and servers. This efficiency is achieved without compromising readability, flexibility, or discoverability. - JSON:API requires use of the JSON:API media type (**application/vnd.api+json**) for exchanging data. # Authentication and Requests We use standard HTTP Authentication over HTTPS to authorize your requests. ``` curl --request GET \ --header 'Content-Type: application/vnd.api+json' \ --header 'Authorization: Bearer YOUR-TOKEN' \ --url https://api.rootly.com/v1/incidents ```
# Rate limiting - There is a default limit of **5** **GET**, **HEAD**, and **OPTIONS** calls **per API key** every **60 seconds** (0 hours). The limit is calculated over a **0-hour sliding window** looking back from the current time. While the limit can be configured to support higher thresholds, you must first contact your **Rootly Customer Success Manager** to make any adjustments. - There is a default limit of **3** **POST**, **PUT**, **PATCH** or **DELETE** calls **per API key** every **60 seconds** (0 hours). The limit is calculated over a **0-hour sliding window** looking back from the current time. While the limit can be configured to support higher thresholds, you must first contact your **Rootly Customer Success Manager** to make any adjustments. - When rate limits are exceeded, the API will return a **429 Too Many Requests** HTTP status code with the response: `{"error": "Rate limit exceeded. Try again later."}` - **X-RateLimit headers** are included in every API response, providing real-time rate limit information: - **X-RateLimit-Limit** - The maximum number of requests permitted and the time window (e.g., "1000, 1000;window=3600" for 1000 requests per hour) - **X-RateLimit-Remaining** - The number of requests remaining in the current rate limit window - **X-RateLimit-Used** - The number of requests already made in the current window - **X-RateLimit-Reset** - The time at which the current rate limit window resets, in UTC epoch seconds # Pagination - Pagination is supported for all endpoints that return a collection of items. - Pagination is controlled by the **page** query parameter ## Example ``` curl --request GET \ --header 'Content-Type: application/vnd.api+json' \ --header 'Authorization: Bearer YOUR-TOKEN' \ --url https://api.rootly.com/v1/incidents?page[number]=1&page[size]=10 ``` x-logo: url: https://rootly-heroku.s3.us-east-1.amazonaws.com/swagger/v1/logo.png servers: - url: https://api.rootly.com security: [] paths: /v1/webhooks/endpoints/{endpoint_id}/deliveries: get: tags: - WebhooksDeliveries summary: List webhook deliveries description: List webhook deliveries for given endpoint operationId: listWebhooksDeliveries parameters: - name: include in: query required: false schema: type: string - name: endpoint_id in: path required: true schema: type: string - name: page[number] in: query required: false schema: type: integer - name: page[size] in: query required: false schema: type: integer - name: filter[status] in: query required: false description: >- Delivery status: pending, success, failed. Comma-separated. Unknown values are ignored; if no valid values remain, the result set is empty. schema: type: string - name: filter[created_at][gt] in: query schema: type: string format: date-time required: false description: >- Created after this timestamp (exclusive). Use ISO 8601 with Z or a numeric UTC offset. - name: filter[created_at][gte] in: query schema: type: string format: date-time required: false description: >- Created at or after this timestamp (inclusive). Use ISO 8601 with Z or a numeric UTC offset. - name: filter[created_at][lt] in: query schema: type: string format: date-time required: false description: >- Created before this timestamp (exclusive). Use ISO 8601 with Z or a numeric UTC offset. - name: filter[created_at][lte] in: query schema: type: string format: date-time required: false description: >- Created at or before this timestamp (inclusive). Use ISO 8601 with Z or a numeric UTC offset. - name: filter[delivered_at][gt] in: query schema: type: string format: date-time required: false description: >- Delivered after this timestamp (exclusive). Use ISO 8601 with Z or a numeric UTC offset. - name: filter[delivered_at][gte] in: query schema: type: string format: date-time required: false description: >- Delivered at or after this timestamp (inclusive). Use ISO 8601 with Z or a numeric UTC offset. - name: filter[delivered_at][lt] in: query schema: type: string format: date-time required: false description: >- Delivered before this timestamp (exclusive). Use ISO 8601 with Z or a numeric UTC offset. - name: filter[delivered_at][lte] in: query schema: type: string format: date-time required: false description: >- Delivered at or before this timestamp (inclusive). Use ISO 8601 with Z or a numeric UTC offset. responses: '200': description: success content: application/vnd.api+json: schema: $ref: '#/components/schemas/webhooks_delivery_list' '400': description: invalid date filter content: application/vnd.api+json: schema: $ref: '#/components/schemas/errors_list' security: - bearer_auth: [] components: schemas: webhooks_delivery_list: type: object properties: data: type: array items: type: object properties: id: type: string description: Unique ID of the webhooks_delivery type: type: string enum: - webhooks_deliveries attributes: type: object allOf: - $ref: '#/components/schemas/webhooks_delivery' required: - id - type - attributes links: type: object allOf: - $ref: '#/components/schemas/links' meta: type: object allOf: - $ref: '#/components/schemas/meta' included: type: array items: $ref: '#/components/schemas/jsonapi_included_resource' required: - data errors_list: type: object properties: errors: type: array items: type: object properties: title: type: string status: type: string code: type: string nullable: true detail: type: string nullable: true required: - title - status webhooks_delivery: type: object properties: endpoint_id: type: string payload: type: string status: type: string enum: - pending - success - failed description: Delivery status response_status: type: integer nullable: true description: >- HTTP status code recorded for the delivery attempt. It is null before the first attempt. For SSRF and transport failures, Rootly generates this code because no destination response was received. delivered_at: type: string nullable: true created_at: type: string description: Date of creation updated_at: type: string description: Date of last update required: - endpoint_id - payload - status - response_status - delivered_at - created_at - updated_at links: type: object properties: self: type: string first: type: string prev: type: string nullable: true next: type: string nullable: true last: type: string nullable: true required: - self - first - prev - next - last meta: type: object properties: next_cursor: type: string nullable: true current_page: type: integer nullable: true next_page: type: integer nullable: true prev_page: type: integer nullable: true total_count: type: integer total_pages: type: integer required: - current_page - next_page - prev_page - total_count - total_pages jsonapi_included_resource: type: object properties: id: type: string type: type: string attributes: type: object additionalProperties: true relationships: type: object additionalProperties: true required: - id - type securitySchemes: bearer_auth: type: http scheme: bearer ````