Fingerprint

Get visits by visitor ID

🚧 Deprecation Notice

This version of Server API is marked as deprecated starting on Jan 7th 2026 according to our API Deprecation Policy. If you still use this version, please follow our migration guide to migrate from this deprecated version to the new one.

This endpoint is deprecated. Use GET /events/search to query visit history or filter across multiple events.

GET /visitors/{visitor_id} currently returns at most one visit in visits, even when no filters are provided. Only information from the Identification product is returned.

Headers

  • Retry-After — Present in case of 429 Too many requests. Indicates how long you should wait before making a follow-up request. The value is non-negative decimal integer indicating the seconds to delay after the response is received.
get/visitors/{visitor_id}

Request

  • Base URL: https://api.fpjs.io
  • URL: https://api.fpjs.io/visitors/{visitor_id}
  • Auth: one of:
    • API key in header Auth-API-Key
    • API key in query parameter api_key

Path parameters

visitor_idstring required

Unique visitor identifier issued by Fingerprint Identification and all active Smart Signals.

Query parameters

request_idstring

Filter visits by requestId.

Every identification request has a unique identifier associated with it called requestId. This identifier is returned to the client in the identification result. When you filter visits by requestId, only one visit will be returned.

linked_idstring

Filter visits by your custom identifier.

You can use linkedId to associate identification requests with your own identifier, for example: session ID, purchase ID, or transaction ID. You can then use this linked_id parameter to retrieve all events associated with your custom identifier.

limitinteger

Limit scanned results.

GET /visitors/{visitor_id} currently returns at most one visit. Use GET /events/search for paginated multi-event queries.

paginationKeystring

Deprecated pagination parameter retained for backward compatibility.

GET /visitors/{visitor_id} currently returns at most one visit, so pagination is not expected. Use GET /events/search for paginated results.

beforeinteger

⚠️ Deprecated pagination method, please use paginationKey instead. Timestamp (in milliseconds since epoch) used to paginate results. GET /visitors/{visitor_id} currently returns at most one visit, so pagination is not expected.

Response

OK.

visitorIdstring required
lastTimestampinteger

⚠️ Deprecated paging attribute, please use paginationKey instead. Timestamp of the last visit in the current page of results.

paginationKeystring

Use this value in the following request as the paginationKey parameter to get the next result.

Changes

No recorded changes to this operation across all 1 revision of this API.