---
title: "Get all logs"
method: GET
path: "/{sub_domain}/api/logs"
tags: ["Logs"]
---

# Get all logs

`GET /{sub_domain}/api/logs`

## Request

- Base URL: `https://api.commpeak.com/dialer`
- URL: `https://api.commpeak.com/dialer/{sub_domain}/api/logs`
- Auth: API key in header `Authorization`

Returns audit log entries created within a time range, so you can review configuration and data changes across your account.

**When to use.** See who changed what and when. To review the history of a single record, pass `object_type` and `object_id` together.

**Parameters.** `from` and `till` (both required) set the start and end of the time range. Optionally filter by `user_id`, or by `object_type` and `object_id` together. You can also set `limit` (between 1 and 500) and `fields` to choose which fields each entry returns.

**Returns.** `{ "logs": [ ... ] }`, where each entry has an ID, creation timestamp, user ID, message, object type, and object ID.

## Path parameters

- `sub_domain` string, required: Dialer Name (subdomain)

## Query parameters

- `from` string, required: Return logs created on or after this date and time.
- `till` string, required: Return logs created on or before this date and time.
- `object_type` string, nullable: Object type to filter by (required when object_id is set). Use PUT /logs to retrieve the full list of available object types.
- `object_id` integer, nullable: ID of the related object to filter by (required when object_type is set).
- `user_id` integer, nullable: Return only logs created by this user.
- `limit` integer, nullable: Maximum number of entries to return.
- `fields` string, nullable: Semicolon-separated list of fields each entry returns.

## Response `200`

Successful Response

- LogsResponse
  - `logs` LogItem[], required
    - `id` integer, nullable: Log entry ID.
    - `created_at` string, nullable: When the log was created.
    - `user_id` integer, nullable: ID of the user who created the log.
    - `message` string, nullable: The message containing information about the log.
    - `object_type` string, nullable: The object type the log relates to (for example Campaign, Leads, Trunk).
    - `object_id` integer, nullable: ID of the related object.

## Other responses

- `404`: Not Found
- `422`: Validation Error

---

[API](https://skmtc.dev/commpeak/apis/commpeak-dialer-api.md) - [All operations](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/llms.txt) - [OpenAPI document](https://skmtc.dev/commpeak/apis/commpeak-dialer-api/revisions/18c5edc07544?raw)