Skip to main content
DELETE
/
visitors
/
{visitor_id}
Delete data by visitor ID
curl --request DELETE \
  --url https://api.fpjs.io/visitors/{visitor_id} \
  --header 'Auth-API-Key: <api-key>'

​
Deprecation Notice

This Server API (v3) was deprecated. If you still use this version, please follow our migration guide to migrate from this deprecated version to the new one. The one year deprecation period will start after the entire ecosystem supports Server API v4. Request deleting all data associated with the specified visitor ID. This API is useful for compliance with privacy regulations.

​
Which data is deleted?

  • Browser (or device) properties
  • Identification requests made from this browser (or device)

​
Browser (or device) properties

  • Represents the data that Fingerprint collected from this specific browser (or device) and everything inferred and derived from it.
  • Upon request to delete, this data is deleted asynchronously (typically within a few minutes) and it will no longer be used to identify this browser (or device) for your Fingerprint Workspace.

​
Identification requests made from this browser (or device)

  • Fingerprint stores the identification requests made from a browser (or device) for up to 30 (or 90) days depending on your plan. To learn more, see Data Retention.
  • Upon request to delete, the identification requests that were made by this browser
    • Within the past 10 days are deleted within 24 hrs.
    • Outside of 10 days are allowed to purge as per your data retention period.

​
Corollary

After requesting to delete a visitor ID,
  • If the same browser (or device) requests to identify, it will receive a different visitor ID.
  • If you request /events API with a request_id that was made outside of the 10 days, you will still receive a valid response.
  • If you request /visitors API for the deleted visitor ID, the response will include identification requests that were made outside of those 10 days.

​
Interested?

Please contact our support team to enable it for you. Otherwise, you will receive a 403.

Authorizations

​
Auth-API-Key
string
header
required

Path Parameters

​
visitor_id
string
required

The visitor ID you want to delete.

Response

OK. The visitor ID is scheduled for deletion.