---
title: "List fingerprint events"
method: GET
path: "/fingerprint/events"
---

# List fingerprint events

`GET /fingerprint/events`

Lists fingerprint events for the authenticated client. Pass exactly one of correlationId or deviceId. Results are newest first.

## Query parameters

- `correlationId` string
- `deviceId` string
- `limit` integer
- `offset` integer

## Response `200`

Page of fingerprint events.

- object
  - `data` FingerprintEvent[], required
    - `id` string, required — Stitch event resource id.
    - `correlationId` string, required — Merchant business reference for this submit.
    - `userId` string — Merchant-supplied user identifier.
    - `deviceId` string, required — Client-scoped device identifier.
    - `metadata` FingerprintMetadata — Flat key-value object stored with the fingerprint event. Nested objects and arrays are rejected. Serialized JSON must be at most 4096 UTF-8 bytes.
    - `signals` FingerprintSignals, required
      - `platform` 'web' | 'ios' | 'android'
      - `ip` object
        - `address` string
        - `country` string
      - `device` object
        - `os` object
          - `name` string
          - `version` string
        - `browser` object
          - `name` string
          - `version` string
        - `userAgent` string
        - `screenResolution` object
          - `width` number, required
          - `height` number, required
        - `timezone` string
        - `languages` string[]
    - `createdAt` string, date-time, required
  - `page` object, required
    - `limit` integer, required
    - `offset` integer, required
    - `hasNext` boolean, required

## Other responses

- `400` — Missing filter, both filters, or invalid pagination.
- `401` — Missing, expired, or invalid access token.
- `403` — The token lacks the client_fingerprinting scope.
- `500` — Unexpected server failure.

## Changes

- **2026-08-27** `8c5a258567d0` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stitch/apis/stitch-api/changes/fingerprint/events/get.md)

---

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