---
search:
  tags:
    - Identity logs
    - GET
seo:
  description: >-
    List identity verification logs, newest first. Optional filters: store,
    source, access… Reference for the GET /identity-logs endpoint in the
    scango.ch API.
sidebar:
  label: List identity logs
  badge: GET
title: List identity logs
type: openapi-operation
---
List identity verification logs, newest first. Optional filters: `store`, `source`, `access` (`allowed` or `denied`), and ISO date range `start`/`end`. Use `limit` and optional `cursor` for pagination. Returns 403 if identity logs are not enabled for the organization.

`GET /identity-logs`

**Responses**

- `200` — Identity logs with meta
- `400` — Invalid parameters or body.
- `403` — API key rejected (see \`Forbidden\`), or identity logs are not enabled for the organization (\`Feature not available\`).

Response example, 200:

```json
{
  "data": [
    {
      "id": "log_01",
      "logType": "identity_check",
      "access": true,
      "store": "wattwil",
      "source": "passport",
      "logDate": "2024-04-20T12:00:00.000Z"
    }
  ],
  "meta": {
    "total": 1,
    "returned": 1,
    "limit": 1,
    "nextCursor": "log_02"
  }
}
```

Response example, 400:

```json
{
  "statusCode": 400,
  "message": "Validation failed for Field: name, Error: Required",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/suppliers"
}
```

Response example, 403:

```json
{
  "statusCode": 403,
  "message": "Feature not available",
  "timestamp": "2024-04-20T12:00:00.000Z",
  "path": "/api/v1/identity-logs"
}
```
