Profiles

Get a person from your cache

Changed on Oct 20, 2026

Never charges and never calls the person index. Returns 404 not_cached when the person has not been enriched in this workspace within max_age_days; enrich them with POST /v1/people:enrich. profile_id may also be a URL-encoded profile URL.

Scope: sourcing:read.

get/v1/people/{profile_id}

Request

Base URL: https://api.recruitmcp.com
URL: https://api.recruitmcp.com/v1/people/{profile_id}
Auth: one of:
- HTTP bearer
- OAuth 2 (authorization code, authorization URL https://recruitmcp.com/oauth/authorize, token URL https://recruitmcp.com/oauth/token, scopes: sourcing:read)

Path parameters

profile_idstring required

Query parameters

max_age_daysinteger

Default 30.

Headers

RecruitMCP-Version'2026-10-13'

API version. Defaults to the version the key was created with. Supported: 2026-10-13.

RecruitMCP-Customerstring

Act inside this customer (cus_…). Ignored for keys bound to a customer, which always act inside theirs.

Response

The cached profile.

profile_idstring required

Search id. The same value search returned when both ids are known.

alternate_idstring nullable

The other profile id for the same person. Null until the person has been enriched and both ids are known.

full_namestring nullable

headlinestring nullable

summarystring nullable

photostring nullable

Profile photo on this API, /v1/media/{token}. The token expires after 7 days; a later response signs a new one. Null when there is no photo.

profile_urlstring nullable

public_identifierstring nullable

skillsstring[]

open_to_workboolean

source'profile_index' | 'contact_provider' required

fetched_atstring date-time

Example response

{
  "profile_id": "lead_8f2a1c_1",
  "full_name": "Ada Peeters",
  "headline": "Backend Engineer at Acme Robotics",
  "profile_url": "https://profiles.example.com/ada-peeters",
  "experience": [
    {
      "position": "Backend Engineer",
      "company": "Acme Robotics",
      "company_url": "https://companies.example.com/acme-robotics",
      "started": "2021-03",
      "current": true
    }
  ],
  "education": [
    {
      "university": "University of Amsterdam",
      "url": "https://example.com/school/university-of-amsterdam",
      "degree": [
        "MSc",
        "Computer Science"
      ],
      "faculty": "Computer Science",
      "started_year": 2013,
      "ended_year": 2019
    }
  ],
  "skills": [
    "Go",
    "Kubernetes"
  ],
  "source": "profile_index",
  "fetched_at": "2026-10-13T09:00:00Z"
}

Changes

Oct 20, 2026ad27b35513a6 Revision changes
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status
- warning
  added the new approval_forced enum value to the / response property for the response status

Operation history