---
title: "Retrieve all logs"
method: GET
path: "/logs"
tags: ["logs"]
---

# Retrieve all logs

`GET /logs`

This will only return Logs that pertain to the current user's tenant. OIH admins can see all logs. The 'filter' query parameter can be used with arbitrary keys beyond those listed here, which will be matched within the events' payload object.

## Query parameters

- `page[size]` integer
- `page[number]` integer
- `filter[tenant]` string
- `filter[service]` string

## Response `200`

A list of logs.

- object
  - `data` Log[]
    - `headers` object, required
      - `serviceName` string, required — The name of the service that spawned this event
      - `createdAt` string, required — The time stamp when the event was spawned
      - `name` string, required — The name of the event
    - `payload` object, required — An arbitrary JSON object containing the event data
  - `meta` Meta
    - `page` integer — Current page (1-based numbering)
    - `perPage` integer — Number of objects per page
    - `total` integer — Total number of objects
    - `totalPages` integer — Total number of pages

## Other responses

- `401` — Missing authorization header. Login via the IAM to receive a token.

## Changes

- **2021-08-19** `271129b34402` — 1 info
  - removed the non-success response with the status `404`
- **2019-07-29** `3deea053f75a` — 3 breaking, 8 warning, 1 info
  - removed the required property `data/items/allOf[subschema #1]/nameSpace` from the response with the `200` status
  - removed the required property `data/items/allOf[subschema #1]/service` from the response with the `200` status
  - removed the required property `data/items/allOf[subschema #1]/timeStamp` from the response with the `200` status
  - deleted the `query` request parameter `filter[nameSpace]`
  - …8 more

[Change history](https://skmtc.dev/openintegrationhub/apis/audit-log/changes/logs/get.md)

---

[API](https://skmtc.dev/openintegrationhub/apis/audit-log.md) · [All operations](https://skmtc.dev/openintegrationhub/apis/audit-log/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/openintegrationhub/audit-log/revisions/271129b34402/schema)