> ## Documentation Index
> Fetch the complete documentation index at: https://docs.peopledatalabs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Examples - Person Changelog API

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](https://curl.trillworks.com/) to convert code from cURL to the language of your choice.

<Callout icon="💡" theme="default">
  ### 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](https://peopledatalabs.canny.io/bugs) or a [feature request](https://peopledatalabs.canny.io/feature-requests) and receive automatic notifications as your bug is resolved or your request is implemented
</Callout>

## Query for Specific IDs Between Versions

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

```python Python3
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)
```

```shell cURL
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"]
}'
```

<br />

## Query for All Added IDs Between Versions

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

```python Python3
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)
```

```shell cURL
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"
}'
```

<br />

## 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".*

```python Python3
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)
```

```shell cURL
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"]
}'
```