Skip to main content

​
Response Data Structure

Here is an example response from the Person Retrieve API:
JSON
See Example Person Record for a full example of the fields included in the data object.

​
Response Fields

​
data.*

The data object contains the entire PDL profile for the person whose person_id matches the input request. Any profile field that we do not have data for will have a null value.

​
billed

The billed field indicates whether we charged an API credit for returning this record. As of the April 2022 (v18) release, the Person Retrieve API only charges credits for returning new or updated records. If an API call returns billed = true, one of the following is true:
  • The API returned a record that was never accessed before across any endpoint.
  • The API returned a record that was previously accessed (across any endpoint) but contains updated information from the last time it was accessed.
In the above cases, we will charge one credit for each API call. If an API call returns billed = false, the API call returned a record that was previously accessed or an error occurred. In these situations, we will not charge any credits for the API call.

​
status

​
Errors

Any request that does not return a 200 success response will instead use the format described in Errors.

Related topics

Output Response - Job Posting Search APIOutput Response - Person Identify APIOutput Response - Person Enrichment APIOutput Response - Person Search APIOutput Response - Person Changelog API