> ## 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://curlconverter.com/) to convert code from cURL to the language of your choice.

<Tip>
  **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
</Tip>

## Query for Specific IDs Between Versions

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

<CodeGroup>
  ```python Python3 theme={null}
  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)
  ```

  ```bash cURL theme={null}
  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"]
  }'
  ```
</CodeGroup>

<br />

## Query for All Added IDs Between Versions

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

<CodeGroup>
  ```python Python3 theme={null}
  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)
  ```

  ```bash cURL theme={null}
  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"
  }'
  ```
</CodeGroup>

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

<CodeGroup>
  ```python Python3 theme={null}
  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)
  ```

  ```bash cURL theme={null}
  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"]
  }'
  ```
</CodeGroup>


## Related topics

- [Person Changelog API](/docs/person-changelog-api.md)
- [Reference - Person Changelog API](/docs/reference-person-changelog-api.md)
- [Output Response - Person Changelog API](/docs/output-response-person-changelog-api.md)
- [Input Parameters - Person Changelog API](/docs/input-parameters-person-changelog-api.md)
- [FAQs - Person Changelog API](/docs/person-changelog-api-faqs.md)