DocumentationAPI Explorer ToolAPI DashboardAPI StatusRoadmapSupport
Documentation
Start Building

Examples - Person Changelog API

Suggest Edits

We've provided code samples in Python and cURL. If you aren't comfortable working in any of these languages, feel free to use this handy tool to convert code from cURL to the language of your choice.

💡

We want your feedback!

Do you see a bug? Is there an example you'd like to see that's not listed here?

Head over to the public roadmap and submit a bug ticket or a feature request and receive automatic notifications as your bug is resolved or your request is implemented

Query for Specific IDs Between Versions

"Show me how these records changed over the v28.2 monthly release"

import requests, json

# Set your API key
API_KEY = "YOUR API KEY"

# Set the Autocomplete API URL
PDL_URL = "https://api.peopledatalabs.com/v5/person/changelog"

# Create a parameters JSON object
PARAMS = {
  "api_key": API_KEY,
}

# Create a query JSON object
QUERY = {
  "origin_version": "28.1",
  "current_version": "28.2",
  "ids": ["123", "qEnOZ5Oh0poWnQ1luFBfVw_0000", "345", "678", "000", "111"]
}

# Pass the parameters object to the Autocomplete API
json_response = requests.post(PDL_URL, params=PARAMS, json=QUERY).json()
# Print the API response in JSON format
print(json_response)

curl -X POST 'https://api.peopledatalabs.com/v5/person/changelog' \
  -H "X-Api-Key: your-api-key" \
  -H 'Content-Type: application/json' \
  -d '{
  "origin_version": "28.0",
  "current_version": "28.1",
  "ids": ["123", "qEnOZ5Oh0poWnQ1luFBfVw_0000", "345", "678", "000", "111"]
}'

Query for All Added IDs Between Versions

"Show me all the records that were added in the v28.0 quarterly release".

import requests, json

# Set your API key
API_KEY = "YOUR API KEY"

# Set the Autocomplete API URL
PDL_URL = "https://api.peopledatalabs.com/v5/person/changelog"

# Create a parameters JSON object
PARAMS = {
  "api_key": API_KEY,
}

# Create a query JSON object
QUERY = {
  "origin_version": "27.0",
  "current_version": "28.0",
  "type": "added",
}

# Pass the parameters object to the Autocomplete API
json_response = requests.post(PDL_URL, params=PARAMS, json=QUERY).json()
# Print the API response in JSON format
print(json_response)

curl -X POST 'https://api.peopledatalabs.com/v5/person/changelog' \
  -H "X-Api-Key: your-api-key" \
  -H 'Content-Type: application/json' \
  -d '{
  "origin_version": "27.0",
  "current_version": "28.0",
  "type": "added"
}'

Query for Specific Field Updates Between Versions

"Show me all the records with updated job_title, work_email or mobile_phone information from the v28.1 monthly release".

import requests, json

# Set your API key
API_KEY = "YOUR API KEY"

# Set the Autocomplete API URL
PDL_URL = "https://api.peopledatalabs.com/v5/person/changelog"

# Create a parameters JSON object
PARAMS = {
	"api_key": API_KEY,
}

# Create a query JSON object
QUERY = {
  "origin_version": "28.0",
  "current_version": "28.1",
  "type": "updated",
  "fields_updated": ["job_title", "work_email", "mobile_phone"]
}

# Pass the parameters object to the Autocomplete API
json_response = requests.post(PDL_URL, params=PARAMS, json=QUERY).json()
# Print the API response in JSON format
print(json_response)

curl -X POST 'https://api.peopledatalabs.com/v5/person/changelog' \
  -H "X-Api-Key: your-api-key" \
  -H 'Content-Type: application/json' \
  -d '{
  "origin_version": "27.0",
  "current_version": "28.0",
  "type": "updated",
  "fields_updated": ["job_title", "work_email", "mobile_phone"]
}'

Updated about 16 hours ago