---
title: "/person/retrieve"
method: GET
path: "/v5/person/retrieve/{person_id}"
tags: ["Person Endpoints"]
---

# /person/retrieve

`GET /v5/person/retrieve/{person_id}`

## Request

- Base URL: `https://api.peopledatalabs.com`
- URL: `https://api.peopledatalabs.com/v5/person/retrieve/{person_id}`
- Auth: API key in header `X-API-Key`
- TypeScript: <https://skmtc.dev/peopledatalabs/apis/api-peopledatalabs-com/docs/v5/person/retrieve/:person_id/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `person_id` string, required

## Query parameters

- `titlecase` boolean

## Headers

- `Content-Type` 'application/json'

## Response `200`

Person Found

- PersonRetrieve
  - `status` 200 | 400 | 401 | 402 | 404 | 405 | 429, required: The return status code for individual Person ID request
  - `data` Profiles, required
    - `url` string: The url of the social profile
    - `id` string: the persistent id related to this social profile (varies by social network)
    - `network` 'aboutme' | 'angellist' | 'behance' | 'crunchbase' | 'dribbble' | 'ello' | 'facebook' | 'flickr' | 'foursquare' | 'github' | 'gitlab' | 'google' | 'gravatar' | 'indeed' | 'instagram' | 'klout' | 'linkedin' | 'linkedin_sales_navigator' | 'medium' | 'meetup' | 'myspace' | 'pinterest' | 'quora' | 'reddit' | 'soundcloud' | 'stackoverflow' | 'twitter' | 'vimeo' | 'wordpress' | 'xing' | 'youtube': The network the profile exists on
    - `username` string: The username associated with the profile
  - `billed` boolean, required: Defines if the user was billed for this request.
  - `metadata` object: User supplied metadata that is returned with the request

## Other responses

- `400`: Request contained either missing or invalid parameters
- `401`: Request contained a missing or invalid key
- `402`: You have reached your account maximum (all matches used)
- `404`: No records were found matching your request
- `405`: Request method is not allowed on the requested resource
- `429`: An error occurred due to requests hitting the API too quickly

## Changes

- **2024-08-22** `e479e570df32`: 1 info
  - endpoint added
- **2024-02-09** `7106eadf93e9`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/peopledatalabs/apis/api-peopledatalabs-com/changes/v5/person/retrieve/:person_id/get.md)

---

[API](https://skmtc.dev/peopledatalabs/apis/api-peopledatalabs-com.md) - [All operations](https://skmtc.dev/peopledatalabs/apis/api-peopledatalabs-com/llms.txt) - [OpenAPI document](https://skmtc.dev/peopledatalabs/apis/api-peopledatalabs-com/revisions/c75f23548f5b?raw)