---
title: "Get Request Logs"
method: GET
path: "/v1/apps/{app_id}/request-logs"
tags: ["Request logs"]
---

# Get Request Logs

`GET /v1/apps/{app_id}/request-logs`

Get request log data for an app. With pagination. Requests to endpoints that have been excluded in the dashboard are excluded here as well.

## Path parameters

- `app_id` integer, required — App ID

## Query parameters

- `app_env_id` integer, nullable — Filter to environment ID, if provided.
- `consumer_id` integer, nullable — Filter to consumer ID, if provided.
- `method` string, nullable — Filter to HTTP method(s), comma-separated.
- `path` string, nullable — Filter to path pattern, supports wildcards (*).
- `status_code` string, nullable — Filter to HTTP status code(s), comma-separated. Can include code classes (e.g., '4xx').
- `start` string, date-time, nullable — Start date and time in ISO 8601 format. Defaults to 24 hours ago.
- `end` string, date-time, nullable — End date and time in ISO 8601 format. Defaults to now.
- `limit` integer — Maximum number of records to return per page.
- `next_token` string, nullable — Token to fetch the next page of records, as returned by a previous request.

## Response `200`

Successful Response

- GetRequestLogsResponse
  - `data` RequestLogItem[], required — List of request log items.
    - `timestamp` string, date-time, required — Timestamp of the request
    - `request_uuid` string, uuid, required — Unique identifier for the request
    - `env` string, required — Environment
    - `consumer` string, nullable, required — Consumer identifier
    - `method` string, required — HTTP method
    - `path` string, nullable, required — Request path
    - `url` string, required — Request URL
    - `status_code` integer, required — HTTP response status code
    - `request_size_bytes` integer, required — Size of the request in bytes
    - `response_size_bytes` integer, required — Size of the response in bytes
    - `response_time_ms` integer, required — Response time in milliseconds
    - `client_ip` string, nullable, required — Client IP address
    - `client_country_iso_code` string, nullable, required — ISO code of the client's country based on the IP address
  - `has_more` boolean, required — Whether there are more records to fetch.
  - `next_token` string, nullable, required — Token to fetch the next page of records, if there are more.

## Other responses

- `404` — App Not Found
- `422` — Validation Error

---

[API](https://skmtc.dev/apitally/apis/apitally-api.md) · [All operations](https://skmtc.dev/apitally/apis/apitally-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/apitally/apitally-api/revisions/a0f67af14cc3/schema)