List identity logs

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

Autorisierung

AutorisierungBearer-Token (API key) · headererforderlich

Organisations-API-Key.

Query-Parameter

storestring

Store id filter.

sourcestring

Document source filter (e.g. swiss_id_card, swiss_drivers_license_old, swiss_drivers_license_qr, passport).

accessstring

Access decision filter.

Erlaubt:alloweddenied

startstring<date-time>

Start of logDate range (ISO-8601).

endstring<date-time>

End of logDate range (ISO-8601).

limitinteger

Page size (1–5000, default 100).

min 1 · max 5000 · default: 100

cursorstring

Opaque document id for the next page. Do not parse. Follow `meta.nextCursor` until it is absent.

Antworten

200Identity logs with meta

dataIdentityLog[]erforderlich

Eigenschaften anzeigen

Array of IdentityLog

idstring

logTypestring

appVersionstring

accessboolean

Whether access was granted.

instancestring

logDatestring<date-time>

storestring

Store id

sourcestring

userstring

birthDatestring

imageUrlstring

rawTextstring

Raw MRZ / scan payload.

metaListMetaerforderlich

Listen-Metadaten. `returned` ist die Länge von `data`. Soft-gelöschte Katalogeinträge fehlen in Listen — `returned` kann kleiner als `limit` sein, auch wenn noch aktive Einträge existieren.

Eigenschaften anzeigen

totalintegererforderlich

Bei Produktsuche (`q`): geschätzte Trefferanzahl. Sonst gleich `returned`. Kann kleiner als `limit` sein, wenn soft-gelöschte Einträge von der Seite gefiltert wurden.

returnedintegererforderlich

Anzahl aktiver Einträge in `data` (soft-gelöschte ausgeschlossen).

limitintegererforderlich

Angewendete Seitengrösse.

offsetinteger

Nur bei Produktsuche mit `q`.

nextCursorstring

Opaker Cursor für die nächste Seite. Gesetzt, wenn weitere Ergebnisse möglich sind. Unverändert als `cursor` übergeben. Bei Soft-Delete- oder `store`-Filter bedeutet `returned < limit` nicht, dass die Liste zu Ende ist.

400Bad request

errorValidationErrorerforderlich

Validierungsdetails.

Eigenschaften anzeigen

formErrorsstring[]erforderlich

fieldErrorsobjecterforderlich

403Unauthorized, or identity logs not enabled for this organization

statusCodeintegererforderlich

HTTP-Statuscode

messagestringerforderlich

Lesbare Fehlermeldung

timestampstring<date-time>erforderlich

pathstringerforderlich

Request-Pfad

Anfrage

curl -X GET "https://dashboard.scango.ch/api/v1/identity-logs" \
  -H "Authorization: Bearer YOUR_TOKEN"

const response = await fetch("https://dashboard.scango.ch/api/v1/identity-logs", {
  method: "GET",
  headers: {
    "Autorisierung": "Bearer YOUR_TOKEN"
  }
});

Antwort

{
  "data": [
    {
      "id": "string",
      "logType": "string",
      "appVersion": "string",
      "access": true,
      "instance": "string",
      "logDate": "2019-08-24T14:15:22Z",
      "store": "string",
      "source": "string",
      "user": "string",
      "birthDate": "string",
      "imageUrl": "string",
      "rawText": "string"
    }
  ],
  "meta": {
    "total": 0,
    "returned": 0,
    "limit": 0,
    "offset": 0,
    "nextCursor": "string"
  }
}