Get Fingerprint

Get a fingerprint by ID

Endpoint

GET /fp/{id}

Path parameters

id

string

required

The ID of the fingerprint

Response body

A JSON object representing the fetched fingerprint

id

string

required

DB

The ID of the fingerprint object

user_id

string

required

DB

The ID of the user owning the resource

---

preset

string

required

FP

Possible values: [windows10, windows11, ubuntu20, ubuntu22, ubuntu24]
The preset used to generate OS-specific parameters, e.g., user agent, navigator platform, speech synthesis voices, etc.

seed

string

required

FP

The seed for the random number generator, used for choosing user agent minor version, and non-unique hardware fingerprints if your plan supports that.

screen

object

required

FP

The screen resolution. The object must have w and h fields, e.g., { "w": 1920, "h": 1080 }

platform_version

string

required

FP

Possible values for Windows: [10.0.0, 14.0.0, 15.0.0] (Win10 / Win11 / Win11)
Possible values for Linux: [5.15.0, 6.5.0, 6.8.0] (Ubuntu 20 / Ubuntu 22 / Ubuntu 24)
The Client Hints platform version

arch

string

required

FP

Possible values: [x64, arm]
Currently, x64 is the only supported value

cpu

int

required

FP

Possible values: >= 1
The number of virtual CPU cores

ram

int

required

FP

Possible values: [1, 2, 4, 8]
The amount of device RAM (in GB). Chrome has capped navigator.deviceMemory values at a maximum of 8, so it is set as the upper limit

gl_vendor

string

required

FP

Possible values for Windows: [Google Inc. (Intel), Google Inc. (NVIDIA), Google Inc. (AMD), Google Inc. (Google)]
Possible values for Linux: [Google Inc. (NVIDIA Corporation), Google Inc. (Google)]
The WebGL vendor

gl_renderer

string

required

FP

The WebGL renderer, e.g., ANGLE (Intel, Intel(R) HD Graphics 620 (0x00005921) Direct3D11 vs_5_0 ps_5_0, D3D11)

---

country_code

string

required

GEO

Possible values: 2 character string, case-insensitive
A two-letter country code provided in the ISO 3166-1 alpha-2 format, e.g., DE, US, CA. Used to fill speech synthesis voices and languages if they are not set in the fingerprint

languages

string

required

GEO

A comma-separated list of languages, e.g., de-DE,de,en-US,en

tz

string

required

GEO

The timezone, e.g., Europe/Berlin

ip4

string

required

GEO

The IPv4 address to use when spoofing WebRTC

ip6

string

required

GEO

The IPv6 address to use when spoofing WebRTC

Example request

JS + Fetch

const id = "732e2a51-ee51-4225-895e-d953e5028a1b";
const response = await fetch(`https://api.ateratti.com/fp/${id}`, {
    headers: { "X-Api-Key": "Your API key" },
});

const fp = await response.json();
console.log(fp);

Example response

200 OK

{
    "id": "22de14c6-ac0a-4919-81d2-eb5bf571e8a1",
    "user_id": "314b9e8c-4212-49e2-9d12-ae16e576d4e8",
    "preset": "windows10",
    "screen": {
        "w": 1920,
        "h": 1080
    },
    "platform_version": "10.0.0",
    "arch": "x64",
    "cpu": 4,
    "ram": 8,
    "gl_vendor": "Google Inc. (NVIDIA)",
    "gl_renderer": "ANGLE (NVIDIA, NVIDIA GeForce RTX 3060 (0x00002504) Direct3D11 vs_5_0 ps_5_0, D3D11)",
    "country_code": "GB",
    "languages": "en-GB,en-US,en",
    "tz": "Europe/London",
    "ip4": "11.22.33.44",
    "ip6": "11:22::33:44"
}

400 Bad Request

{
    "message": "You must provide an ID"
}

Error responses

Code	Description
400 Bad Request	The request is invalid
404 Not Found	There's no fingerprint with the specified ID