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 |
|---|---|---|---|---|
origin_version | Yes | The older version for comparison. Must be a valid version and cannot skip versions with current_version. | None | 28.1 |
current_version | Yes | The newer version for comparison. Must be a valid version and consecutive to origin_version. | None | 28.2 |
type | No* | Specifies the type of changelog to return. Supported values are added , deleted , updated, merged, opted_out
| None | "added" |
ids | No | List of person IDs to query changes for. Minimum length: 1 Maximum length: 60,000 | None | ["qEnOZ5Oh0poWnQ1luFBfVw_0000"] |
fields_updated | No | Specifies fields updated between versions (only allowed with type: "updated"). Each field must match a top-level field in the Person Schema. | None | ["work_email"] |
scroll_token | No | Token for pagination when retrieving large result sets. | None | \---NdonAvTwEk-ml9yzfFA_0000 |
api_key | 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 x-api-key field. For more information, see the Authentication page. | 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 |
|---|---|---|
status | Integer | The API response code (see a description of our error codes). |
data | Array[Object] | An object containing the list of PDL record IDs matching the input query parameters (and any related metadata).Only returned if status == 200 |
data.type | String | The user-supplied type value provided in the input query. This value will be null if no value was specified in the input query. |
data.origin_version | Float | The user-supplied origin_version value provided in the input query. This value will be null if no value was specified in the input query. |
data.current_version | Float | The user-supplied current_version value provided in the input query. This value will be null if no value was specified in the input query. |
data.scroll_token | String | The scroll token to use to fetch the next batch of results for the query. This value will be null if no additional records matching the input query exist. |
data.added | Array[Object] | The list of added records matching the input query. The maximum size of this array is limited to 1000 records. |
data.deleted | Array[Object] | The list of deleted records matching the input query. The maximum size of this array is limited to 1000 records. |
data.merged | Array[Object] | The list of merged records matching the input query. The maximum size of this array is limited to 1000 records. |
data.opted_out | Array[Object] | The list of opted_out records matching the input query. The maximum size of this array is limited to 1000 records. |
data.updated | Array[Object] | The list of updated records matching the input query. The maximum size of this array is limited to 1000 records. |
error | Array[Object] | An object containing an error message and additional details.Only returned if status != 200 |
error.type | String | The type of error event. |
error.message | String | The error message providing details on why the query was unsuccessful. |
error.valid_versions | String | The list of valid versions passable to either the origin_version and/or current_version input parameters. |
error.valid_types | String | The list of valid type values passable to the type input parameter. |
error.valid_fields_updated | String | The list of valid field values passable to the fields_updated input parameter. |
Abridged Response Data Structure
Here is an example response from the Person Changelog API when querying forupdated records. (See a full example response in the next section.)
JSON
{
"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)
Input Query (click to toggle)
Python
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)
Python
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)
JSON
{
"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 aroundstatus = 400 errors:
JSON
// 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']
}
}