Reference - Person Changelog API
Endpoint
The endpoint for the Person Changelog API is: https://api.peopledatalabs.com/v5/person/changelog.
This endpoint only supports POST requests (see the code examples for usage)
Difference Between GET and POST RequestsSee this article for a comparison of the differences between GET and POST requests. The biggest difference is that POST requests don't have any limit on the amount of data that you can pass in a request.
Access and Billing
By default, all active API keys have free access to the Person Changelog API.
When monitoring usage, each call to the Person Changelog API counts against the daily rate limit, regardless of the records available.
Rate Limiting
Our default rate limits are 100 requests per minute for self-serve customers and 500 requests per minute for enterprise customers.
We are able to increase rate limits up to 5,000 requests per minute for enterprise customers. If you are interested in higher rate limits, please reach out to us.
Input Parameters
For More Details, See Input Parameters - Person Changelog API.You can also click on the individual parameter names in the table below to view more information on them.
Parameter Name | Required | Description | Default | Example |
|---|---|---|---|---|
Yes | The older version for comparison. Must be a valid version and cannot skip versions with | None |
| |
Yes | The newer version for comparison. Must be a valid version and consecutive to | None |
| |
No* | Specifies the type of changelog to return. Supported values are
| None |
| |
No | List of person IDs to query changes for. | None |
| |
No | Specifies fields updated between versions (only allowed with | None |
| |
No | Token for pagination when retrieving large result sets. | None |
| |
No* | Your secret API key. While we do not require this as part of the request parameters, if you do not provide it here, then you must provide it using an alternative means, such as in the headers using the | None |
Output Response
For More Details, See Output Response - Person Changelog APIYou can also click the field names in the table below to view more information on them.
Field Name | Type | Description |
|---|---|---|
Integer | The API response code (see a description of our error codes). | |
| An object containing the list of PDL record IDs matching the input query parameters (and any related metadata). Only returned if | |
| The user-supplied | |
| The user-supplied | |
| The user-supplied | |
| The scroll token to use to fetch the next batch of results for the query. This value will be | |
| The list of | |
| The list of | |
| The list of | |
| The list of | |
| The list of | |
| An object containing an error message and additional details. Only returned if | |
| The type of error event. | |
| The error message providing details on why the query was unsuccessful. | |
| The list of valid versions passable to either the | |
| The list of valid type values passable to the | |
| The list of valid field values passable to the |
Abridged Response Data Structure
Here is an example response from the Person Changelog API when querying for updated records. (See a full example response in the next section.)
{
"status": 200,
"data": {
'type': "updated",
'origin_version': "28.0",
'current_version': "28.1",
'scroll_token': "---NdonAvTwEk-ml9yzfFA_0000",
'updated': [
{
'id': '----0VvBmPGusSt2fKgAOQ_0000',
'additional_metadata': {
'fields_updated': ['num_sources', ...],
'contains': ['tMJIEibzvrMffGkZaDUXbA_0000', ...]
}
},
...
]
}
}
Full Example Response
Input Query (click to toggle)
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"
}
# 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)import requests, json
pdl_url = "https://api.peopledatalabs.com/v5/person/changelog"
params = {
"api_key": "YOUR API KEY",
}
post_params = {
"origin_version": "28.0",
"current_version": "28.1",
"type": "updated",
}
json_response = requests.post(pdl_url, params=params, json=post_params).json()
print(json_response)Output Response (full):
{
"data": {
"type": "updated",
"origin_version": "28.0",
"current_version": "28.1",
"scroll_token": "---NdonAvTwEk-ml9yzfFA_0000",
"updated": [
{
"id": "----0VvBmPGusSt2fKgAOQ_0000",
"additional_metadata": {
"fields_updated": [
"num_records",
"num_sources",
"possible_emails",
"profiles"
],
"contains": [
"tMJIEibzvrMffGkZaDUXbA_0000",
"----0VvBmPGusSt2fKgAOQ_0000",
"LmxXoUCG2xbsQAqaav3tjA_0000",
"OmZXCwkHj8EhAXXVXk3BUA_0000",
"6JRnhvFxRgZQ34vVVF4UeA_0000"
]
}
},
{
"id": "----17KBiqhscAQ39BZnfw_0000",
"additional_metadata": {
"fields_updated": [
"experience",
"profiles"
],
"contains": [
"LAHCt0cOGWPeL-ZP8aByaA_0000",
"----17KBiqhscAQ39BZnfw_0000",
"gYwOhROgeL7I0C4L0LmN-A_2000",
"vUD2IQaxrwxSkfLBA0V-vQ_0000",
"1pAADCtddOW8eMA8Dxkdmw_0000",
"xeksI2Gsi9qsGvk2awmLig_0000"
]
}
},
{
"id": "----3D5YuLm98HP6nwwTLA_0000",
"additional_metadata": {
"fields_updated": [
"experience",
"job_history",
"job_last_verified",
"location_last_updated",
"num_records",
"profiles"
],
"contains": [
"FSBqBznY6ocsXTbJnsPi6w_0000",
"8XH3o2hsRQ1ts7QOeFXDPw_0000",
"FNkfffYLtczFAHY1LgscGw_0000",
"RsiG32fa-hGLjeOhCET5Ag_0000",
"FBBnTy142AcaNSD9cfb2-w_0000",
"Jxcqc9nTOuvMc8zYgAzq6w_0000",
"MZoK8Liu6RjIL6EnuzbA1Q_0000",
"3B3rlvMKdjYx5rFHI8GCbg_0000",
"Y2QBRzkiWzfhjtL19Wp73Q_0000",
"0FhZffBxhKpE1SNuhWxG1w_0000",
"eh6Id7xjqobK63hezY6-KA_0000",
"wGKPPG-8gkyKPXNhB-zl4A_0000",
"m4MVUNMa79ucqAcJq81Ieg_0000",
"Qp2J6LqWvLwfrH6HDlAuzg_0000",
"9IR0RVgxXS8NHPo5n0eQVg_0000",
"Cd02eqohTR5FvfoNZ9xrTQ_0000",
"m1-bb3B4jg9bMf0-8-SkVQ_0000",
"nulU600Ba8rUHk-klTP3ew_0000",
"iHA7baoeTDgfuS3O8u1-AA_0000",
"Oq74Zw3snvYBddNDzaX51w_0000",
"8e2Pv8A-uqVLZbdVv-6IXQ_0000",
"SjtbuaOFdnoi7DSruqRJVA_0000",
"LvXXC18mMWH96gay0c085A_0000",
"JfxPSBRfCBXeSUF6QJNcgQ_0000",
"qndVTGI5g1LrJcqpM3yUdg_0000",
"N8nVpOdMQVtkc61VXVdYlA_0000",
"7WeRemtIQeTThYmhbP6KnQ_0000",
"wYUWgfdqaldebJE-s43dUw_0000",
"nr5uYeBTaZUfDWiBzfzmGg_0000",
"kNxw0yVBoQwtuoGb63vQrA_0000",
"7r5zg4nETwdsGvVIBWnJ0Q_0000",
"rlWnh7C9t4oaHg8LYEmhpw_0000",
"txl4wIOljfADstFpbhPusA_0000",
"dRDpaUhKPuRsIQ1iEeiCZg_0000",
"iVKvhBsNpazm6UvAVygSdw_0000",
"KdMG5loLTaU0rA-aUczB3w_0000",
"5PaFWFLPyBkEVRGiQ9Kkiw_0000",
"VD8rryVZFXjYkBG0eM4y0w_0000",
"k0LaHI-1ZPCyiwDgcvOn3g_0000",
"kYFCQMG2FWB5F6OacAmlhw_0000",
"bQq8ZxCKUT4lX6heXeluIw_0000",
"kMO-BBUvGqhcXIBwdPueUg_0000",
"OTaC47CgxPze4KzA1Bx0Kg_0000",
"4S2ykoDMsVgXF20uK88sBg_0000",
"MUoc3Yk85BA6L-9S2q1JCA_0000",
"yRBpn-D-eeYXc-JZnl6pQQ_0000",
"yi6LBlECyVYOBXn345zmDQ_0000",
"YgPge7jKYCEjLZeTyopZag_0000",
"EgeE-cL4Lq8Zk5MRrQqx0g_0000",
"xqPLwOhgmd8z028MIfH3Sg_0000",
"PKNDbfDJSVymD6jN1WCP7Q_0000",
"hSo-VzeB4HJn5zRmKrTTvA_0000",
"ayM7Dg3vszX0UB7FjNT49w_0000",
"7Ebc3-oiwsU3ENkEVgtopQ_0000",
"FFJrqKbqgwtC9froZ-VocQ_0000",
"m-lUUqu2IubZBGkpS1ZG5A_0000",
"DgsB4nG0HNKkG1-U78di8A_0000",
"YK6gNb6KC5sRQUpLLiKQtA_0000",
"lXjniUUzgLZt8Q0k6Er9pA_0000",
"Lpoh7kbQ8CjSvoesrD7gsg_0000",
"bHjhav4ZC3aC9aAT7gZeYA_0000",
"lEbkXYmZ2BBPiM2sG1s2Ig_0000",
"RdKuiuofdA2iw7ScWRn2Pg_0000",
"-5EOgSPcXihik9jjxLjAsQ_0000",
"WhrFJnIHYUTIJOyoaoaWuQ_0000",
"nm7cm45sT6j5t7QU7bD8EQ_0000",
"hYqz-NHHm50iFBVN4eaciA_0000",
"Bf6HzaqtWhLgitksBNtWYA_0000",
"YTJ6eAZK9ogWSI-SNCE5EQ_0000",
"lkr5uI9sLBImm4vAWoOBRg_0000",
"3qksJ2kB55C7qobvTIrQQg_0000",
"1rvydfARkBdQk-XCiYZLYQ_0000",
"LA2PlceoO99ciWKnP2-G9Q_0000",
"keZS2wg14muUWGnohp3BjA_0000",
"1u88hB4QzL1j3e56v9VlXg_0000",
"eB4D6R9TOAv9k-0Ra2i67g_0000",
"wnIHtusQVVa90iKjII82xQ_0000",
"OMiBsngoZiwB0HmVANAbDA_0000",
"b3uCBruNpe6jsBqlWyapIw_0000",
"0y6hiG3rKBdQAIJJX6zPwA_0000",
"v8BJBPAaJ7gECdOSkbcPaA_0000",
"ekz4JghOYB6IoGC7fL63JQ_0000",
"snTeIVrJ9TyBvgRGpRG9xQ_0000",
"TIYj8ESa7AKmBBskXh7B0g_0000",
"lXhURLAu3RgfnlPkowfCQw_0000",
"05P2DgB7EkGnPzNo4ZEepA_0000",
"7G2lTEzPIOhNxYZrepuBEw_0000",
"IZb1-R2MDkAtXWEDBBVB2A_0000",
"WBM2qvDTvWHBEXkT3-O3Lw_0000",
"XwB8wNODFaPwLyUybqf7dA_0000",
"GkQOBaBpyBVB-zEFKWDVkw_0000",
"s3aqx5LLbKO5f3VV91roeQ_0000",
"Pf8n1qjdSoBwIlGehC8UmQ_0000",
"wFEZ2E6lqUl5sps95tuY8w_0000",
"BwBfuMYwpeZnBLNqy0pdaA_0000",
"e6N0ZFcFKDBefUKApxmRSw_0000",
"bYkNuz9mmQ447pRuo-KoeA_0000",
"jRRDDlRHNkRLi7TBfYPnNA_0000",
"wTovhZ7mnMFdOoEYKkX29g_0000",
"eW6MfrGB9PPpbEQBGgjGAg_0000",
"DJZG3fd6zFyhnpeEwsyvZw_0000",
"LkkU-oIiEszMW4uluBIPHw_0000",
"D-yIOK2IOSW6bkkPji9D6w_0000",
"NfSs6PBJRa7JITUtjTn68g_0000",
"----3D5YuLm98HP6nwwTLA_0000",
"dQow0mBq4AuSVZE68BzRQw_0000",
"Ir6ViXpT7ZB68PXpT4JxIA_0000",
"RLYDJV6jQ7on5d4SMWAlWw_0000",
"PfSyfGsrfvUM9delPaqsMA_0000",
"n9uZLTKZNNypLN9ZNoYUQw_0000",
"BsZEfo6LL6HUwx5Bqkna0w_0000",
"PXIF3O--NFCJDlf7j6PEqA_0000",
"hMNbnGJqmkrPu8jbgU6C0A_0000",
"3h27jdgmRbB0SjlaaymYEA_0000",
"BLyWbfzJAHUr89j2zorUAw_0000",
"paiDhF32X4QLwaYBellV0A_0000",
"02N5ag2ufUt8y-L42yWeHQ_0000",
"1iAbNjQQUDjmGqTHwwDinQ_0000",
"LpHsPz9Fq3UWP91XYI-Wjg_0000",
"yarCmxtvMcDYihbHi6XEfg_0000",
"2rDyXoIT9hCjh8Q461xGxQ_0000",
"n3y-oTn2BZLDBhtcREXwfA_0000",
"EScrct2ywmqbv1lITDaxaA_0000",
"oY1w6fmXU1mjYMfSYN3eIw_0000",
"4gN3fC4ipj0k2gDZ5hIiPw_0000",
"kMauUF2f-JOU9p4ksjCi4g_0000",
"Vv0D6JALopSA33M2jJPd2A_0000",
"-bHxNduPeC40Y16Wtz6TLQ_0000",
"H5vL4tzI5MXpUyH0iZkO9w_0000",
"1JF75lXpc7081MBwc4KxWA_0000",
"BOGctlpMCEd9WQnFzBSgfQ_0000",
"qhdB6RGvKg2yNN0B3-uyIQ_0000",
"VbCeGF7guscOnws-6kDyYg_0000",
"snHhINX2BNZY4FvmFtL3PQ_0000",
"tveXnBnGLy15QJ4wIn24Bw_0000",
"IpD81UTz1vlkpTGq4bF4ig_0000",
"hdgCvN4ZkamRcX0g6bd8aA_0000",
"X-Fguc-c6VtzJXUwKKNPLQ_0000",
"2qmBGDsdwQjRLE6fUuajCw_0000",
"mayTrMTizfh1w5KKMBLqUA_0000",
"7bl5Fcub0ik63k1yJhkQBg_0000",
"bC0TpIFziiROkyVdhsRvxQ_0000",
"1n6p07Vzy2PABseHjWrkLg_0000",
"s1JQE9NlaZITHVgroUFLEQ_0000",
"DdbG7-sIqwZh1xijKmU-8A_0000",
"YtkizLoSN5mIxTg7qSxaSw_0000",
"a2Kj3JhgY8V6KJe-2eb5Bw_0000",
"urwV8B-Cu9PZDSxNIx8ZuQ_0000",
"SOXBAUNZBDyWewQGH8dLbA_0000",
"IBYft0v2g6T0K53yIbOAAQ_0000",
"DadpDIq8hVqWmEHbC3OB8A_0000",
"IdwqbJpq1BnoA82MaB5NHg_0000",
"O6QkiwMLTy9qB3ML9rDTYg_0000"
]
}
},
{
"id": "----3dWFqzbDhLvB-jMBgw_0000",
"additional_metadata": {
"fields_updated": [
"location_last_updated",
"num_records",
"profiles"
],
"contains": [
"----3dWFqzbDhLvB-jMBgw_0000",
"Z68YPAGvG-DKuYSlLw2hzA_0000",
"OBs0lBQThZkAwtYTh9rdbA_0000",
"fHtLT-PDXU1L1CxhhFoEAw_0000",
"5OJMao5xFBtwzo4kSusxgA_0000"
]
}
},
{
"id": "----4wBwuW3QHLXw4a0J1Q_0000",
"additional_metadata": {
"fields_updated": [
"experience",
"job_history",
"job_last_verified",
"location_last_updated",
"num_records",
"profiles"
],
"contains": [
"kfWbduBRNPX99dghKkU7iA_0000",
"bzbBHFmvST3wQ-aIYSoBtA_0000",
"XgBC3yYYABfrlIfuhfXS8A_0000",
"----4wBwuW3QHLXw4a0J1Q_0000",
"QDy9dOn2xGDjaIBO7lhl1A_0000",
"gt4c8KBBnn51EIAuit23uA_0000",
"YYMHxnZEdABsaJNKDB5BYA_0000",
"jgrmYwirsJfecnOIFX02mQ_0000",
"er4FgSDZ2SouiCHq2Ga7kw_0000",
"A7LCQEU2PY9X0TvPNUWjDg_0000",
"U9Msl8z908yjyG0J202Wuw_0000",
"GCZq0wcM2-9BGs20uliBlw_0000"
]
}
},
{
"id": "----5mPJcZmILmeS6qL4BA_0000",
"additional_metadata": {
"fields_updated": [
"experience",
"job_history",
"job_last_verified",
"num_records",
"profiles"
],
"contains": [
"-gKWYpAoAQ1AiKIgvbyUuw_0000",
"ZrCHZ5oGEzlN31Hoj5yQQA_0000",
"4I4X3EqaUj7J4j8dwg7mcw_0000",
"----5mPJcZmILmeS6qL4BA_0000",
"CVQG-C6a7FSKUlTvETDS2w_0000",
"9zD-ZbgHCc6VZUN0Mv8FVw_0000",
"RkvdOXxMigh0MNhSuiDhDw_0000",
"IJygmJFdUU1kxxML4KVt4Q_0000",
"g7G5mfcgLGCxpumuPS6vnw_0000",
"bMSvMysThXfvu5bqyUu4Zw_0000",
"UhVExP5AmYwLLo4Zmoyd0A_0000",
"HtbKygPB3tq2bpV5ob0ZPw_0000",
"17m6ALNcNoB1dp5KLJ5fwg_0000",
"UV2xLAprpRgGTaH-4mjDAQ_0000",
"2dsuzsOJOpqNuYiYlDg6HA_0000",
"BAqhv15xBKYGbWOs35ZAJA_0000",
"Tu6GboBNgkNZ3jyMVjrJbQ_0000"
]
}
},
{
"id": "----8NzoGWHfbXTaV29a4A_0000",
"additional_metadata": {
"fields_updated": [
"mobile_phone",
"phones"
],
"contains": [
"----8NzoGWHfbXTaV29a4A_0000"
]
}
},
{
"id": "----ADNqrZpBjS0ZQg-8EQ_0000",
"additional_metadata": {
"fields_updated": [
"location_last_updated",
"num_records",
"profiles"
],
"contains": [
"CN3MEHucfGcLBg5qwCVqmg_0000",
"----ADNqrZpBjS0ZQg-8EQ_0000",
"bYO6LBAc6xxtAYgKNRhC3g_0000",
"nBtNkfe-1CD6veIihgxaRw_0000",
"1PFIJbO1zQXNGh5hOdq6yQ_0000",
"iMq8wmxZ3wNX64DdcdUWRQ_0000",
"kcjaZzr1Eu9w2vnE2BW-3Q_0000",
"0zeUozKjVzl90nabSGJ-tw_0000",
"XllpaB-D5hCCxuXDReslog_0000"
]
}
},
{
"id": "----AsawKsMDGIJdBagw1Q_0000",
"additional_metadata": {
"fields_updated": [
"linkedin_connections",
"possible_profiles"
],
"contains": [
"5FcO7JJK0RKbfxULJnW1JA_0000",
"Q7oDEVBzIJVtSznQz2jblw_0000",
"Ki4YjJNeMpsVVMxHzyPIvQ_0000",
"TKhJwH9ljbLOSM2smUgHaQ_0000",
"74Mj9MyzLU1nnTAxmmaDog_0000",
"SsW7r7PhTBI7Ig1ftwx0Jw_0000",
"F15ixGM0xVeXFN26OcN43A_0000",
"3aGtF7rGFVjvhEBr6EbM5Q_0000",
"wk2n5g4-20Ik2uHXSue89A_0000",
"empJlslVt4BRyT5BiSxF4A_0000",
"BuYSBleY9-3maE3ZozgSXA_0000",
"3Xt9OevmHGMuWD9ok-xxpQ_0000",
"EDDGBiqunmb2VH08tothKg_0000",
"Us6W7c3jdmrV7gTCqFsPBw_0000",
"AAptqKGE9LmM3PUnOBbysA_0000",
"kp4Hhlvwr9NbQc5o2mb1EA_0000",
"QVaPQ94H5icWPs0sbZx44Q_0000",
"Peli0-zgeqMvXjevmuj8qA_0000",
"vonB3wGect5GAKLM-jkBHw_0000",
"Aif7aXlQsfeBmhvnaGUBUw_0000",
"Lr-ATLIiAAu81jyHDAjMZA_0000",
"----AsawKsMDGIJdBagw1Q_0000",
"kJFBWfvqzK7MXVtJ4Awg7Q_2000",
"HyL2e24-jjbed6n80yv1RQ_0000",
"fqQB6GrdQkZTva5PzM2VAg_2000",
"1RJINfaMZrBK-Lk8fh4fog_0000",
"N1s44NvSdKBy-XVJms8wPw_0000"
]
}
},
{
"id": "----BQqScy-qTPcFOBTw8w_0000",
"additional_metadata": {
"fields_updated": [
"experience"
],
"contains": [
"ExbK1U3iHr1GE-vkkLy-ww_0000",
"----BQqScy-qTPcFOBTw8w_0000",
"RDNJ-XtAdH92lnrBSIfOyg_0000"
]
}
},
{
"id": "----DgOXHXqm8PbbmVQxqg_0000",
"additional_metadata": {
"fields_updated": [
"experience",
"job_history",
"job_last_verified",
"location_last_updated",
"num_records",
"profiles"
],
"contains": [
"Q3MJsB8ZdQe8ueDiYaiARw_0000",
"beIRE4il61783Ay7ZPyTLQ_0000",
"BRKW81YvMqIOMztlIUO2WA_0000",
"8M3LKGuld20rpbwQCylyyw_0000",
"8YyM-FksMn8ixYetE-S69w_0000",
"9p2yx9799C1XRp73yghxWw_0000",
"o8ynCLgLPddUXLkvOJbtGA_0000",
"1tKsg71fGbxJ6l7fFNqb2A_0000",
"oSvtXNFTNzO3SfzGwTAJGQ_0000",
"yWNM5wpTrkgzt0x7OBuaBQ_0000",
"MZ-pVYnVLRcAZbHOiXCWXw_0000",
"338rTGxcTLFzxQc5p5aZ6A_0000",
"Ob8K7CGr2IZ7W8FAAhphRQ_0000",
"fVZlnKjp2dTI-H5xOpVV8Q_0000",
"0hCZaVImpDpdYBdm69hWUg_0000",
"w1TkV6vRqwafJZqSpp8BIQ_0000",
"S8zB76IYq56ByYiGL-2tmg_0000",
"KrfuIbxBvpP-75PnzpAiMQ_0000",
"jpAxlASdcNFiDk7YbqDbuA_0000",
"DNkiOa0tbtemVtodiDkJbg_0000",
"q4eQ7eURJmFDFU33T-si8w_0000",
"lolw77tJ3ZXcUa88hjwB6Q_0000",
"iI8HVlHs9Bn32RJB1j350Q_0000",
"oK5SAQs3rJPQneQnDRZz6g_0000",
"cG-Cp1DaBYf2JdNXU54qpg_0000",
"iOQZXY16CuZnvpHB0NSUkA_0000",
"7fHGuMl7FiBuX8kv-jp9ag_0000",
"kkRHT3cgsE62dlKUaTo6Dw_0000",
"nrARzV3vMNa9-zKlEAp4Jw_0000",
"KTAGYpwh2WMxmxKua9FkOQ_0000",
"EYjnPdKwGr9Ix5t1C2kohQ_0000",
"Zp-HMSaENaCthB0rGWRwug_0000",
"UB7Umzc6EKxhWG9FKRl3xA_0000",
"----DgOXHXqm8PbbmVQxqg_0000",
"lk2tMBDbOyH0qktwlMrmKQ_0000",
"WgspskNcirxxec7iUeHgDA_0000",
"TSzYY3j5AJ6zXYmKmfSLIQ_0000",
"rhRHyZ4c-vSDeBw1l4hjZA_0000",
"Bw8X8KRp50taAuNL50Qu2Q_0000",
"SEFeuDwWBPWovhcHPkXXrQ_0000",
"qYf2VmPiPuYCM7HiB8mDDg_0000",
"8rwaBGGxYmVDbylMcwCkYA_0000",
"XDJ2QR4BWN95vhktNDpFPA_0000",
"Re5pgtrfnfEhp1xYYGEBjg_0000",
"dtCinLIFBcBzw4eDL7-UYw_0000",
"JUJrD-jwFNIptSXUWa006Q_0000",
"-VDZmk6thW1y2yfBXYPR8w_0000",
"g96tXoy-l8Wq6x-ETtEmmw_0000",
"m645Q2UcnVcL1pyFIgL7tg_0000",
"43h5oB6k1H8HNO5eCztPbA_0000",
"2-HBkRaJ7LRd7d6-V5dbUg_0000",
"D4xw3-JL2Tb9zB0BIEqTCQ_0000",
"gBhdcLHXH8WpAFtbc0RBmg_0000",
"xRNgLhWZiafAHbs-L4jPfQ_0000",
"74O5DoNfBj7BFLnM55eaPw_0000",
"0jr5KsYT3CRSMUU2BcrVug_0000",
"eJviB3Skw-uVU-l35t-6kA_0000",
"sF6aUJ4J-x7FKXlcXIph7A_0000",
"WwS4tOmTd-E9yjcDGaZd2Q_0000",
"dEg3NSB4z9BPONL9ssA0Kg_0000",
"I2-UVEL27XPs97KgeR8g1w_0000",
"IL4O00rAoF3EiHo3z0OELA_0000"
]
}
},
{
"id": "----DxjrURM7-aBRNzyQIA_0000",
"additional_metadata": {
"fields_updated": [
"experience"
],
"contains": [
"----DxjrURM7-aBRNzyQIA_0000",
"Rn-w7uT9sItB8f9oXF31uA_0000"
]
}
},
{
"id": "----EECHR1EJ6lt5SZchHg_0000",
"additional_metadata": {
"fields_updated": [
"location_last_updated",
"num_records",
"profiles"
],
"contains": [
"ipMuZNHmQ-9pXw1dcTB9dQ_0000",
"B-tcOi5wD--OF7xl81XWHw_0000",
"DPlALmfv2KsYrHgXaIjWhA_0000",
"eMLtBqAA0SA7BhFo7VinTw_0000",
"3HsTdl1IATQaXzjGvmRqLg_0000",
"YB6bB8t7B0UGXQoVi04qkQ_0000",
"EWCVj1dpTh7o7i-J0QKzmA_0000",
"M5GtxMYKBdQdyP2bCwt8gA_0000",
"rdeAQ5Xzv38o0NjNhzK0lw_0000",
"sigx2ikBiMhMvecXDoSXAw_0000",
"zONgmn-Q2WlGRJ364AI3kQ_0000",
"----EECHR1EJ6lt5SZchHg_0000",
"ulG0boVXAu931ONKQGiwBQ_0000"
]
}
},
{
"id": "----EhPbqvA4xWj1en1Jig_0000",
"additional_metadata": {
"fields_updated": [
"location_last_updated",
"num_records",
"profiles"
],
"contains": [
"xpXDm6LHibjVrEpIFiNKfg_0000",
"DpfBUu6xBJi30fZz-3txKw_0000",
"0uyI2U0yt8nT2FmpXliQRw_0000",
"pCDxkZNh8BsWBnfNln7-RA_0000",
"uwfUQZ0fPAuVL7nJ7VU4UA_0000",
"xxm4VMwA2zp0SrwSLhklIg_0000",
"y4c7HGq62J6vpccKvl2Hxg_0000",
"GHBHPC95lmqDr8pSSDjCEA_0000",
"WFtfJPdmn0AezuLwti66Kw_0000",
"4pK9A44LTu5isM1quLEiAQ_0000",
"sRqSBGttW8XuMN4reBzZdg_0000",
"----EhPbqvA4xWj1en1Jig_0000",
"sH1jPANp6q1JLj65FmaP7Q_0000",
"zDmY-hwoUkyBztIFEse87Q_0000",
"mwncBpZG11ptjp4T3HjCAg_0000",
"bl7Rh9roQJMp0VHev7y14g_0000",
"I0jU13tvoZrAUfqbDjOpdQ_0000",
"9z8uRpi2v40XibI8vxWuDg_0000",
"MXJzRAsGmFol4e2bavKo6Q_0000",
"zGJ7QI309YpvEFzIvonlig_0000",
"xR5LwZ3toD0BMxRrgB-vyA_0000",
"w6JzDqdKbipEbXL71mYVeA_0000",
"KbCMvI1REh-zDfBivQN8Tw_0000",
"T9hOTEdfWWApOqv26SOG1g_0000"
]
}
},
{
"id": "----EslkxiIpb47eTrwE2w_0000",
"additional_metadata": {
"fields_updated": [
"num_records",
"num_sources",
"possible_emails",
"profiles"
],
"contains": [
"ORTSri-KAoWhgS9LaRLtCQ_0000",
"8RMk6lHrx9KSU3ww7COh9A_0000",
"iEV3qF0rj1YVc-HU5RONEA_0000",
"mCaHTQHhkT0w0tlui0oX5Q_0000",
"bxElk6fsQac8b61z1hzsvQ_0000",
"GGNPlU427Z5SBbtpbITU1w_0000",
"iiMlfEpa17iHCfloCyIx6A_0000",
"4DmwlyHZWP7Jvq18-5j29w_0000",
"1I-tkLBxihjdWqHjUutgUQ_0000",
"bjTgGUqll8ZZhJH4U6XVFQ_0000",
"1wFXvAw-q36jAzIEfogruQ_0000",
"aT1ahPIjXj34EaOk3ZcwOg_0000",
"76vRkLWVvdv4ffB0iBmKmw_0000",
"pNGgUsGZbxBz8ep8ymiR3g_0000",
"3diy6qkIBRjoBdmIafL9iQ_0000",
"6wnZgUHdzJSTu47ncHtqKw_0000",
"7UEi6gB7dbfDDNu6dS8XOg_0000",
"A7Oolfpz4nalPnlyBvryOw_0000",
"rwQfW-jBLqw8aXj6Us8-xw_0000",
"VkT1D4ExI6rVtnwz2Mt1TA_0000",
"moEY8b4XJg8c-UJjVIQ8MA_0000",
"cCh7R2wsA5sGfJIkDEWUSg_0000",
"JXfVFKEzUCgLqjPoAXRRSg_0000",
"Sq48IvqUeXzrTH0oBpreiw_0000",
"3xIGc7tIZTEDEXTS8c6WfA_0000",
"x00dEW2ema5K5lPSBjXcrQ_0000",
"7kfft5I0fqXL0P8CfU-Meg_0000",
"BMisOErLCGs0LNtg1M7BQg_0000",
"Bx-EeOfsaF9VmuWKW2pScQ_0000",
"cK6SbFm5ChaMWU8O90sEYg_0000",
"zSpKJcY-AQpfSfGET1xnyQ_0000",
"8IYELfUJLjug6QhpMln59A_0000",
"tWZL4IU7LKcg0XGSpwJcVg_0000",
"YE4whhyD2ZsawB0qcCaAcw_0000",
"frzg2YWd2Y3PX1ABHFc6Yg_0000",
"8-pvWjTu-6taWpGdCZlJ0Q_0000",
"uyuh679JUfYzoSFK7JKAgg_0000",
"VpFAlJBtzkvHOyP4K7pMeg_0000",
"DPznsMBzI1u0GZnkcJBivQ_0000",
"Ytxzu1Ha1sOdDJvQmCW3ww_0000",
"SvOgvB1hwZbYPWyKh7vO4A_0000",
"eI5FMcLBWmx4rmMlbgiygA_0000",
"9MfvBpNce8WKWNdI4vrraw_0000",
"k0k5bCPGSJCOX-BINH91kg_0000",
"vQi0ZuNeqZLB2c1omZv8mQ_0000",
"S0J2Fr16bgrR59oxiswUpg_0000",
"PRZ1ZTQgyPKY7EwVdD000w_0000",
"cJ-qyM7zPMCZMUjUlmabGA_0000",
"1dUAvFUg4usztNCPCB1rdg_0000",
"760983GYC1FcPtwcTPbtNw_0000",
"AMK0BP3nWmPg1ceAV1BiiA_0000",
"jJOZuN7tOjogSB1GVWh4oA_0000",
"LvtVTzH4rv4QW9O5maBG2Q_0000",
"gQKLDEz4cNNi8xFZdFLzUg_0000",
"GUSyD4GbRTWARtuMfcxZEQ_0000",
"5MO7HsR5Vhe5g52J7s9z1A_0000",
"A8DmFPBfktAdeLscZyzzGQ_0000",
"gK0lrgXibD5aRgetBBSMTA_0000",
"bqBieEMlo8xUKVTeod8agQ_0000",
"3HBByw22XXav8LVtwO5ChQ_0000",
"iwJlehENAKvs3YHqzOq-Kg_0000",
"zcGfky-3yeBm6JH19MB57w_0000",
"fqOjnpZslocsBLil2zCTNg_0000",
"KOJs5J6XFZyedAgx0NxUHg_0000",
"6yYyb47I9opLTruu-6eGrQ_0000",
"JecX99YI-VBYvroGqekpnQ_0000",
"6GCLHgD5bTG5G2IH78de3g_0000",
"wW2SSXxv-xsJn8I2mWOyYA_0000",
"-wcg1lGziVXT2B0MsT8uBQ_0000",
"hLViEqzKJI1sKB2Zn66wIw_0000",
"DXhSB8ItVnpfY-Qkyr83dA_0000",
"PlF8apTe6WBQprw-R6dZDQ_0000",
"EzM8txOBlBKVoHCSft-sqg_0000",
"KjEofjaJdIfiXROqAmkwmA_0000",
"FzOB-DbF-2KUY593tgGPzw_0000",
"g5W5XA3BhD8jm8V91CO4xw_0000",
"T20mMk8VcXksWTMBOeK72g_0000",
"DKNLoB8LAJDSe1DOvbQMNQ_0000",
"WiJuBapp10oaQXTyeUY0BA_0000",
"5aK-JMPdGT8tLTZvgATl5Q_0000",
"Br9dRmMiroLEguEgFDbB3g_0000",
"OcoXPE2zXqXViXaJys7f1A_0000",
"AOYqzqJhEOFFmJerDS3b8A_0000",
"HdGZPdEBPDOuoysoIsRnJw_0000",
"LkgbWIUGsUctbB6dZLWMXQ_0000",
"ydUjN2H7jfnvlJ-FltXHTA_0000",
"C44qreC-Yb3kV7RneIyNcw_0000",
"IvPDVCYOr69p6WDJBCBBBQ_0000",
"baiJi6Wq6qfw5N2KSsR0IA_0000",
"N8KWtBu1zsUBV1AJxVCYbw_0000",
"n21kmdmPkdJ8BAHgK-TDEw_0000",
"emf4XNY7n-DiVjnvqLJElw_0000",
"Ccw4lHASOK5YeGCamTZTqw_0000",
"tEezR3kYpsof1NRgu4KZ1A_0000",
"BGpPzeIBeRGsYZekPP4YRA_0000",
"33o91-6Un1KSuoGBEbIMWw_0000",
"ME115flsBgvgxRQMbJ8ytQ_0000",
"JKTk0Qo2IiDN2cNC9CnGyA_0000",
"xtTsYhfKeO0SXjjBdXkKWA_0000",
"OphbfgA9rBcnlm1jEVoseQ_0000",
"E23ZbdzQVSHkMbdUKJ2snQ_0000",
"oiinXNMJYarhLeUFRWvmaQ_0000",
"EseRFVtAZUdwiyqizLzF5g_0000",
"qYA-qUT3xAW9ROzR0mfBKQ_0000",
"B9irljxJvAU88p-y5RHLeA_0000",
"DtTBSHFj6CGd4YpJ8okcRg_0000",
"OcWuBpBAB22Uy4-ef34BqA_0000",
"YfyBtjsNvlPSdggFNudUsw_0000",
"z0AVBvwgBVI8MH43NCtWIw_0000",
"oGtdhyJSgncYPh-EuyFKzw_0000",
"OQDPwQPBR8PQvO6P-BpMrA_0000",
"l1dndQSWd1Tt4r6o8QmDCA_0000",
"TlK8BSvRa8YpLSbClTvRLg_0000",
"LachosHEjLa5MRRgMvdpKg_0000",
"JqRotq2RtQZnkaoIacBR4A_0000",
"kPItncjljeXGGz1Y82nBQg_0000",
"KNrkAQuP174BGIYV1TZn7Q_0000",
"cxgjMV8vxBkjGU8zDbBo2A_0000",
"i1TEQv6EXAhhzPbZF-UTsQ_0000",
"RXyHDTODoJtVHm6TRh1ubg_0000",
"688BnkJ7cU0-aYGuY8q1sA_0000",
"udvas1P0QQAIb59FSBRGVQ_0000",
"-t39RJykSSLvB27fRq84gg_0000",
"NzSa4O0nElM7yN0MJrzsEg_0000",
"----EslkxiIpb47eTrwE2w_0000",
"hGUq9v47g9HBZKcuF3rGfQ_0000",
"UZftr7LqaSH5ceNvAcH8Jw_0000",
"Fyt7Yjj3nY0nAyIH8gfUyw_0000",
"b3kgx34nBAhnXkZOv3wIjQ_0000",
"ehl4TgkEhUDR7-iwGb71dQ_0000",
"GgOCVSe09cFvZp0H9kza7g_0000",
"dc3vQ45l1Y5dpwmyTrtnRw_0000",
"ur0fhksBlFBWP1BKuGcU7A_0000",
"wD3xuLyGs4alQDm1z-3gdQ_0000",
"cDYjxOl8ZFiEBHsvmp2HDg_0000",
"as05BXNueHvAFvGc006JSQ_0000",
"YrKtVgDJNYHa4pmi6R8eOg_0000",
"RbyqKk5uVzIKnQbSu-vA8A_0000",
"-wtx7GFKGR7OkZgDVhJeyA_0000",
"p8XhNTdO6sIij6hrKsyBnA_0000",
"hWINjuK0rvSTjVGTyLguYg_0000",
"UQHvfHUp9FSwAYo8eqzCeA_0000",
"YPWYLMJ69JbaI6mjrNbMxw_0000",
"ucCSepa9L7lHGQNBEdRrSA_0000",
"qzaM452x66a5JnC4mORYRA_0000",
"dbJTUt86oFcF0qJga2GX4Q_0000",
"FjvXiW6Qbzs0u3Q2v5AvTw_0000",
"qonQeJGZ6xElIjeEmQjikQ_0000",
"bDBUGD3t2GdR4UsjGG5hWA_0000",
"ZqLsvtgTQwzYXg0DLpegpw_0000",
"nHw5Fin19fN1qqb8sIhekA_0000",
"hBT7r3IOABMaQ7orqHUFHg_0000",
"46Ac1aedtS5azk3TshkgsQ_0000",
"M7oXsNPm8IkvzLOsPkFDGg_0000"
]
}
},
{
"id": "----FJD49JsbkHJa1mDwCQ_0000",
"additional_metadata": {
"fields_updated": [
"experience",
"job_history",
"job_last_verified",
"location_last_updated",
"num_records",
"profiles"
],
"contains": [
"6TLijqV8mOvQxXzexfhvlQ_0000",
"F9dnony37bt-So3CbKsDOA_0000",
"mlPWhsAufvjtYqi-zVAQ-A_0000",
"----FJD49JsbkHJa1mDwCQ_0000",
"ZeR-8HfojEIwpWpM-3jGuA_0000",
"Bj3z7TeIWclHN3fvUXX6wQ_0000"
]
}
},
{
"id": "----KmoBQVzvNEHgBtGpgw_0000",
"additional_metadata": {
"fields_updated": [
"location_last_updated",
"num_records",
"profiles"
],
"contains": [
"RG1ZHJVg6o0ZIJpBOZaWDg_0000",
"3UWYBTM4CTLszi3w8RjXGA_0000",
"v5cE-VaHHN9mDJugiDcowQ_0000",
"miSn3LXLZiZ1jmJoq5yElg_0000",
"82bBqhysrlwOjCGbzcIxgw_0000",
"----KmoBQVzvNEHgBtGpgw_0000",
"MxavbFbHwymd9CnPgJU2fg_0000",
"BaYUSoYWDL9-5H3-AdH-bA_0000",
"KGom4jpstl6Kw2S-PYtVkw_0000",
"fGB2UwAHCdyeYCCG3J06TQ_0000",
"xxJJkNDSxsy6BduBRBX8zA_0000",
"Z9ZK0PIkZ2I2bA608bB4VQ_0000",
"8LxmeImkuicn0tYaCiSyOQ_0000",
"12WIAHfUF8ZDXQ9O7-EiiA_0000",
"D-4SXkWKZB8NVZ1UHxF4cw_0000",
"b4hCQMXFXps290jfekqP6g_0000",
"YAn8oKAj48XTzeM67bKkfA_0000",
"lV532RAFB2DfPZYMZBJ7bg_0000",
"MmSIVu0R8OnQFe3EkqLgwg_0000",
"m1ZpBvqlikTlQQuAMKP5sQ_0000"
]
}
},
{
"id": "----L67Bqoe4IFOtQKGpCA_0000",
"additional_metadata": {
"fields_updated": [
"experience",
"job_company_linkedin_url",
"num_records",
"num_sources",
"possible_emails",
"profiles"
],
"contains": [
"GyTBSAhC49hIOTe6gwzCvw_0000",
"JwlLST8RddDrM5Dhlv1l3A_0000",
"SCVPdQemzqJBIMbtcg1oOA_0000",
"ANRxvvE9BeahdAKTU0LVLw_0000",
"1gqJlehFpPII1aMynSJmrw_0000",
"-9tkBcYMjnk4qicM3X2hLQ_0000",
"UR8b5tjSJFBBKramwOZDRQ_0000",
"HyM4Eu4kUmh3-ME03B1XqQ_0000",
"vwyexUnzKl2rkjHnYBJQFA_0000",
"yvK-sEsldcyXOloYdY0ZRA_0000",
"uiKLdu2LPhEFVg0pdupNGw_0000",
"5mbLYl3RBxZauTPe5QTGGA_0000",
"-qsPzRe2QMwKWfuIhVLuvw_0000",
"nvgzjBWr6pzYguBzzvkKbA_0000",
"GxjpAiOYvp0qbiJyFy8bwg_0000",
"MD76YGsiTUBwAaLb7gGbnw_0000",
"FRR8c9BFYHwCRjcAxPKJfw_0000",
"----L67Bqoe4IFOtQKGpCA_0000",
"koK1-HZh97DY8EBGexxirQ_0000",
"lE87JSdUpueVWYhDVirXcQ_0000",
"0tnzDpGrSXcO1mgBGXIyVg_0000",
"gdJuxaohlHUJYwEGOTvACg_0000",
"VXlbzXlD6RAfnwLqzxlwZQ_0000",
"SBWlLJbqa6NxFeBK8Uwugw_0000",
"PEPLEkYKATwbZiLOiZlGNw_0000",
"IB7kRXcUTKEeBnkEn9JmoQ_0000",
"BpG4YjoSHxZ6LI7HA-csgA_0000",
"v5qMPPN08p5SoHEYXHhGWA_0000",
"olf5sZmenIXf6fbCsAMFwg_0000",
"jTfOGBJg7IgZBxOOj05KYQ_0000",
"hh0iUyEM0AbWBCbKUA1ANQ_0000",
"RhPxaya08ZYIkTeff3PDUA_0000",
"AC9gKW7wr7kMDWIL4Iqu1Q_0000",
"B4Tw5JlWYKAbYkPaFS11Ug_0000",
"uYGGBg8iLfRhHNzGslrWHQ_0000",
"7ZigSegO0Mgez9WeP-RclA_0000",
"f36eQBKnkWGXxtWjMkkTug_0000",
"Qg-o8bro25qrUNDaO51TtA_0000"
]
}
},
{
"id": "----OsAp6KjL3MEC5TRWAg_0000",
"additional_metadata": {
"fields_updated": [
"profiles"
],
"contains": [
"GmsKCpLq-52j6MkrwHMsHA_0000",
"v0TAgTKncxByB5BEpo1xTw_2000",
"----OsAp6KjL3MEC5TRWAg_0000",
"AgsHiB6R05I78m3f-SLtQg_0000",
"IVlpyrambOfcUTGWnUIBQw_0000",
"-v5GQc7QHUgJ65EBRRzGnw_0000",
"kVoFoS-JehvRSHitgDZUlQ_0000",
"75PZ5Hh7byE8Drg8CBDeHw_0000",
"sKmZ3adKFUlCzCDEokjHbw_0000",
"kMpIgElqe9ganjIguw1qzQ_0000",
"3j39Ec6xObLpgXowWr7xjA_0000",
"VNpbCq9QO4HXBhAzujrVdg_0000",
"OdgBLmPxZfBl4GOaheeycw_0000",
"CiNAlxAWDx85BUIDTdng4Q_0000",
"IcS0idfXQU4giB1SPl1EOQ_0000",
"5KIBkEASTBIBwsJzZgdHVw_0000",
"xx3rKbnkBr8WCVE5-b5-6w_2000",
"96UnYVz1lFLhINWpaq08Gg_0000",
"kd63jHoBuJEMiVVnr4Z-Uw_0000"
]
}
}
]
}
}Errors
If the request encounters an error, it will instead return an Error Response in the format described in Errors.
This endpoint will also provide some additional details around status = 400 errors:
// Invalid "type" input parameter
{
"status": 400,
"error": {
"type": "invalid_request_error",
"message": "invalid type",
"valid_types": ['added', 'deleted', 'updated', 'merged', 'opted_out']
}
}
// Invalid "origin_version" or "current_version" input parameter
{
"status": 400,
"error": {
"type": "invalid_request_error",
"message": "origin_version and/or current_version must be a valid version",
'valid_versions': ['28.1', '28.0', '27.2', '27.1', '27.0', '26.0']
}
}
// Non-consecutive "origin_version" and "current_version" input parameters
{
"status": 400,
"error": {
"type": "invalid_request_error",
"message": "origin_version and current_version must be consecutive and cannot skip versions",
'valid_versions': ['28.1', '28.0', '27.2', '27.1', '27.0', '26.0']
}
}
// Using "fields_updated" field
{
"status": 400,
"error": {
"type": "invalid_request_error",
"message": "origin_version and current_version must be consecutive and cannot skip versions",
'valid_versions': ['28.1', '28.0', '27.2', '27.1', '27.0', '26.0']
}
}
Updated 3 days ago