---
title: "List delivery logs"
method: GET
path: "/v1/messages/{message_id}/delivery_logs"
tags: ["Messages"]
---

# List delivery logs

`GET /v1/messages/{message_id}/delivery_logs`

Returns a paginated list of delivery logs for the specified message.

## Path parameters

- `message_id` string, required

## Query parameters

- `after` string
- `before` string
- `page_size` integer

## Response `200`

OK

- ListMessageDeliveryLogsResponse — A message delivery log response.
  - `items` MessageDeliveryLog[], required — Returns a paginated list of delivery logs from the downstream provider for the specified message. For Knock in-app channels, the delivery logs will always be an empty list.
    - `__typename` string, required — The typename of the schema.
    - `environment_id` string, uuid, required — The ID of the environment in which the message delivery occurred.
    - `id` string, required — The unique identifier for the message delivery log.
    - `inserted_at` string, required — Timestamp when the message delivery log was created.
    - `request` MessageDeliveryLogRequest, required — A message delivery log request.
      - `body` object — The body content that was sent with the request.
      - `headers` object, nullable — The headers that were sent with the request.
      - `host` string — The host to which the request was sent.
      - `method` 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' — The HTTP method used for the request.
      - `path` string — The path of the URL that was requested.
      - `query` string, nullable — The query string of the URL that was requested.
    - `response` MessageDeliveryLogResponse, required — A message delivery log response.
      - `body` object — The body content that was received with the response.
      - `headers` object, nullable — The headers that were received with the response.
      - `status` integer — The HTTP status code of the response.
    - `service_name` string, required — The name of the service that processed the delivery.
  - `page_info` PageInfo, required — Pagination information for a list of resources.
    - `__typename` string, required — The typename of the schema.
    - `after` string, nullable — The cursor to fetch entries after.
    - `before` string, nullable — The cursor to fetch entries before.
    - `page_size` integer, required — The number of items per page (defaults to 50).

---

[API](https://skmtc.net/knocklabs/apis/knock-api.md) · [All operations](https://skmtc.net/knocklabs/apis/knock-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/knocklabs/knock-api/revisions/4b8499dddbc5/schema)