Delete data by visitor ID

curl --request DELETE \
  --url https://api.fpjs.io/visitors/{visitor_id} \
  --header 'Auth-API-Key: <api-key>'

import requests

url = "https://api.fpjs.io/visitors/{visitor_id}"

headers = {"Auth-API-Key": "<api-key>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {'Auth-API-Key': '<api-key>'}};

fetch('https://api.fpjs.io/visitors/{visitor_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fpjs.io/visitors/{visitor_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Auth-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fpjs.io/visitors/{visitor_id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Auth-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api.fpjs.io/visitors/{visitor_id}")
  .header("Auth-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fpjs.io/visitors/{visitor_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Auth-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

Visitors

Delete a visitor ID

Use this API to request the deletion of all data associated with a specific visitor ID.

Upon a request to delete data for a visitor ID,

The data collected from the corresponding browser (or device) will be deleted asynchronously, typically within a few minutes. This data will no longer be available to identify this browser (or device). When the same browser (or device) revisits, it will receive a new visitor ID.
The identification events made from this browser (or device) in the past 10 days are typically deleted within 24 hrs.
The identification events made from this browser (or device) outside of the 10 days will be purged as per your data retention period.

The following timeline illustrates which events are deleted and which remain after a DELETE API request:

Day 1:  First visit from browser A. (Assigned visitor ID: VID1000)
Day 2:  Browser A revisits. (Assigned the same visitor ID: VID1000)
Day 13: Browser A revisits. (Assigned the same visitor ID: VID1000)
Day 14: Delete VID1000
Day 15: Browser A re-visits. (Assigned a different visitor ID: VID9999)
Day 15: GET /events/day-13 (Returns 404. The event is within the 10 days of deleting VID1000 and will have been deleted)
Day 16: GET /events/day-2 (Returns 200. The event is outside of the 10 days of deleting VID1000 and is still available)

Availability

This API is available only for Enterprise plans upon request. If you are interested, please contact our support team.

Rate limits and daily quota

The rate limits and daily quota for this API differ from those for our other API.

The maximum number of DELETE requests that can be made in an hour cannot exceed 30 RPH, and the maximum number that can be made in a day cannot exceed 500 RPD.

You can request an increase to these limits by contacting our support team.

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>'

import requests

url = "https://api.fpjs.io/visitors/{visitor_id}"

headers = {"Auth-API-Key": "<api-key>"}

response = requests.delete(url, headers=headers)

print(response.text)

const options = {method: 'DELETE', headers: {'Auth-API-Key': '<api-key>'}};

fetch('https://api.fpjs.io/visitors/{visitor_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.fpjs.io/visitors/{visitor_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "DELETE",
  CURLOPT_HTTPHEADER => [
    "Auth-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.fpjs.io/visitors/{visitor_id}"

	req, _ := http.NewRequest("DELETE", url, nil)

	req.Header.Add("Auth-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.delete("https://api.fpjs.io/visitors/{visitor_id}")
  .header("Auth-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.fpjs.io/visitors/{visitor_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Delete.new(url)
request["Auth-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

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.

Search events Webhook

JavaScript Agent

Server API

Automation Intelligence API

Policy and Upgrades

Device Reputation Network API

Management API

Server SDKs