---
title: "Retrieve Person"
method: POST
path: "/people/retrieve"
tags: ["People"]
---

# Retrieve Person

`POST /people/retrieve`

Retrieve and normalize a person profile from identifiers.

## Request body

- PersonRetrieveRequest
  - `identifiers` object, required — Known identifiers for the person. At least one identifier is required.
    - `linkedinUrl` string, uri — LinkedIn profile URL, e.g. https://www.linkedin.com/in/yahia-bakour/.
  - `timeoutMS` integer — Optional timeout in milliseconds for the request. If the request takes longer than this value, it will be aborted with a 408 status code. Maximum allowed value is 300000ms (5 minutes).
  - `tags` string[] — Optional tags for tracking usage. Up to 20 tags, each 1 to 50 characters.

## Response `200`

Person retrieval succeeded.

- PersonRetrieveResponse
  - `status` 'ok', required — Response status.
  - `code` 200, required — HTTP status code.
  - `person` Person, required
    - `profile` PersonProfile, required
      - `fullName` string — Person's full name.
      - `headline` string — Short professional headline.
      - `location` string — Person's listed location.
      - `summary` string — Brief profile summary.
      - `profilePictureUrl` string, uri — Profile image URL.
    - `education` PersonEducation[], required — Education history.
      - `institution` PersonNormalizedName, required
        - `display` string, required — Display name.
        - `normalized` string — Standardized name, when available.
      - `qualification` string — Degree, certificate, or credential.
      - `fieldOfStudy` string — Area of study.
      - `description` string — Additional education details.
      - `dates` PersonDateRange
        - `startDate` PersonDate
          - `year` integer, required — Year value.
          - `month` integer — Month value, when known.
          - `day` integer — Day value, when known.
        - `endDate` PersonDate
          - `year` integer, required — Year value.
          - `month` integer — Month value, when known.
          - `day` integer — Day value, when known.
        - `isCurrent` boolean — Whether the entry is current.
    - `experience` PersonExperience[], required — Work history.
      - `company` PersonNormalizedName, required
        - `display` string, required — Display name.
        - `normalized` string — Standardized name, when available.
      - `title` string, required — Role or job title.
      - `description` string — Role description.
      - `dates` PersonDateRange
        - `startDate` PersonDate
          - `year` integer, required — Year value.
          - `month` integer — Month value, when known.
          - `day` integer — Day value, when known.
        - `endDate` PersonDate
          - `year` integer, required — Year value.
          - `month` integer — Month value, when known.
          - `day` integer — Day value, when known.
        - `isCurrent` boolean — Whether the entry is current.
    - `skills` PersonSkill[], required — Listed skills.
      - `name` string, required — Skill name.
      - `normalized` string — Standardized skill name, when available.
      - `proficiency` string — Skill proficiency, when available.
  - `metadata` object, required — Additional response details.
    - `identifiers` object, required — Identifiers returned for the person.
      - `linkedinUrl` string, uri — LinkedIn profile URL.
    - `personalWebsiteUrl` string, uri — Personal website URL, when found.
    - `urlsAnalyzed` string[], required — URLs reviewed for this profile.
    - `sourcesAttempted` string[], required — Source categories checked.
    - `sourcesSucceeded` string[], required — Source categories with data.
  - `key_metadata` KeyMetadata — Metadata about the API key used for the request. Included in every response whenever a valid API key is provided, even when the response status is not 200.
    - `credits_consumed` integer, required — The number of credits consumed by this request.
    - `credits_remaining` integer, required — The number of credits remaining for your organization after this request.

## Other responses

- `400` — Bad request - Invalid identifiers
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Insufficient permissions or usage limit exceeded
- `408` — Request timeout
- `429` — Rate limit exceeded
- `500` — Internal server error
- `502` — External provider error

---

[API](https://skmtc.net/context/apis/context-dev.md) · [All operations](https://skmtc.net/context/apis/context-dev/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/context/context-dev/versions/182f532c2552/schema)