---
title: "Retrieves a set of 25 fingerprints based on specified criteria, with the most recent browser versions at the beginning of the list. Note that calling this method multiple times will return different sets of fingerprints."
method: GET
path: "/fingerprints"
tags: ["Fingerprint"]
---

# Retrieves a set of 25 fingerprints based on specified criteria, with the most recent browser versions at the beginning of the list. Note that calling this method multiple times will return different sets of fingerprints.

`GET /fingerprints`

## Request

- Base URL: `http://localhost:5050`
- URL: `http://localhost:5050/fingerprints`
- Auth: none declared
- TypeScript: <https://skmtc.dev/kameleo-io/apis/kameleo-local-api/docs/fingerprints/get.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `deviceType` string
- `osFamily` string
- `browserProduct` string
- `browserVersion` string

## Response `200`

OK.

- FingerprintPreview[]
  - `id` string, required: The unique identifier of the fingerprint. You can use this as a reference to create a new profile from this fingerprint.
  - `device` Device, required
    - `type` string, required: Type of the device. Possible values are: 'desktop', 'mobile'.
    - `name` string, nullable: Name of the device. This is only available for mobile profiles.
  - `os` Os, required
    - `family` string, required: Specifies the operating system family. Possible values are 'windows', 'macos', 'linux', 'android', 'ios'.
    - `version` string, required: The specific version of the OS. For example it helps you determine the exact version of the macOS.
    - `platform` string, required: The OS's platform, indicating the processor architecture (e.g., 64-bit, 32-bit)
  - `browser` Browser, required
    - `product` string, required: Product of the browser. Possible values are 'chrome', 'firefox', 'edge', 'safari'.
    - `major` integer, required: Major version of the browser.
    - `version` string, required: Exact version of the browser.
  - `webglMeta` WebglMeta, required
    - `vendor` string, required: The UnmaskedVendor field from WebGL context
    - `renderer` string, nullable: The UnmaskedRenderer field from WebGL context
  - `userAgent` string, required: The user agent of the fingerprint.
  - `fontsCount` integer, required: The number of fonts in the fingerprint.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `default`: Error

## Changes

- **2026-08-03** `dc959e78ce25`: 5 warning
  - added the new `running_mobile_profiles_limit_reached` enum value to the `errorCode/allOf[#/components/schemas/ErrorCode]/` response property for the response status `400`
  - added the new `running_mobile_profiles_limit_reached` enum value to the `errorCode/allOf[#/components/schemas/ErrorCode]/` response property for the response status `401`
  - added the new `running_mobile_profiles_limit_reached` enum value to the `errorCode/allOf[#/components/schemas/ErrorCode]/` response property for the response status `402`
  - added the new `running_mobile_profiles_limit_reached` enum value to the `errorCode/allOf[#/components/schemas/ErrorCode]/` response property for the response status `403`
  - …1 more
- **2026-06-16** `4d1d53a322e2`: 10 warning, 35 info
  - removed the optional property `code` from the response with the `400` status
  - removed the optional property `code` from the response with the `401` status
  - removed the optional property `code` from the response with the `402` status
  - removed the optional property `code` from the response with the `403` status
  - …41 more
- …earlier changes not shown

[Operation history](https://skmtc.dev/kameleo-io/apis/kameleo-local-api/changes/fingerprints/get.md)

---

[API](https://skmtc.dev/kameleo-io/apis/kameleo-local-api.md) - [All operations](https://skmtc.dev/kameleo-io/apis/kameleo-local-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kameleo-io/apis/kameleo-local-api/revisions/d3225562612a?raw)
