---
title: "/person/retrieve/bulk"
method: POST
path: "/v5/person/retrieve/bulk"
tags: ["Person Endpoints"]
---

# /person/retrieve/bulk

`POST /v5/person/retrieve/bulk`

## Query parameters

- `titlecase` boolean

## Headers

- `Content-Type` 'application/json'

## Request body

- object
  - `requests` unknown[] — requests contains a list of objects that have a Person ID and optional metadata object.
    - unknown

## Response `200`

Person Found

- PersonRetrieveBulk
  - `data` 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

---

[API](https://skmtc.net/peopledatalabs/apis/api-peopledatalabs-com.md) · [All operations](https://skmtc.net/peopledatalabs/apis/api-peopledatalabs-com/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/peopledatalabs/api-peopledatalabs-com/revisions/c75f23548f5b/schema)