RErecruitwithatlas
People

Get a person by ID

Changed on

Use this endpoint to retrieve the full details of a single person from your Atlas account by their ID.

This is the endpoint to use when you already know which person you want - for example, after finding them via the Search endpoint, receiving their ID from a webhook, or storing it from a previous Create call. It returns everything Atlas knows about the person in one response.

What you need to provide: Just the person's ID in the URL path (e.g. /api/v1/people/abc-123). Person IDs are UUIDs returned by other endpoints like Search, Lookup, or Create.

What you get back: The person's full profile - basic info, profile photo (avatarUrl), identities, headline, address, work experience, education, compensation, custom attributes, source, and metadata.

Merged people: When people are merged in Atlas, the result is a new person record with a new ID, and every original ID stops being a live person. Requesting an original ID here does not return 404: the response is 200 with the surviving person's full data, data.id is the surviving ID, and merged is { fromId, toId }, where fromId is the ID you requested and toId is the surviving ID (this endpoint follows the merge chain when the person a record was merged into was itself merged later). Replace any stored reference to fromId with toId. For a live person, merged is null.

Only this endpoint follows merges. Other endpoints treat a merged-away ID as a missing person (PATCH /api/v1/people/{id}, for example, returns 404), so resolve an old ID here before using it elsewhere. Merged-away people appear in List people with includeDeleted=true as tombstones whose mergedToId names the person they were merged into; deleted people appear there with mergedToId: null.

If no person exists with the given ID in your agency, or the person was deleted without being merged, the endpoint returns a 404 error.

get/api/v1/people/{id}

Request

Path parameters

idstring uuid required

Atlas person ID

Example:123e4567-e89b-12d3-a456-426614174000

Response

Person details

status'ok' required

Example response

{
  "data": {
    "avatarUrl": "https://berg-atlas-public.s3-eu-west-1.amazonaws.com/550e8400-e29b-41d4-a716-446655440000/7c9e6679-7425-40de-944b-e07fc1f90ae7/avatar/a1b2c3d4.jpeg",
    "companyContact": {
      "id": "b3f1c2d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d",
      "relationship": "prospect",
      "title": "VP of Engineering"
    },
    "source": {
      "system": "api",
      "externalId": "124456"
    },
    "identities": [
      {
        "type": "email",
        "value": "mscott@example.com",
        "isPersonal": true,
        "isPrimary": true
      }
    ],
    "headline": {
      "role": "Regional Manager",
      "company": "Dunder Mifflin",
      "roleStartedAt": "2023-04-01"
    },
    "experience": [
      {
        "companyName": "Dunder Mifflin",
        "companyId": "550e8400-e29b-41d4-a716-446655440000",
        "companyLinkedinId": "12345678",
        "companyDomain": "dundermifflin.com",
        "role": "Regional Manager",
        "description": "Led day-to-day operations for a 3-member team. Developed and maintained dashboards in Power BI.",
        "startDate": "2021-04-01"
      }
    ],
    "education": [
      {
        "institutionName": "University of Scranton",
        "degree": "Bachelor of Science",
        "fieldOfStudy": "Business Administration",
        "grade": "3.4 GPA",
        "startDate": "2012-09-01",
        "endDate": "2016-06-30"
      }
    ],
    "compensation": [
      {
        "type": "actual",
        "taxMethod": "gross",
        "currency": "USD",
        "relevantDate": "2024-06-01",
        "basicSalary": 120000,
        "bonusSalary": 30000,
        "totalSalary": 150000,
        "expectedSalaryMin": 130000,
        "expectedSalaryMax": 160000,
        "expectedBonusSalaryMin": 10000,
        "expectedBonusSalaryMax": 50000
      }
    ],
    "customAttributes": [
      {
        "attributeName": "Priority",
        "attributeType": "options",
        "values": [
          {
            "optionValue": "Yes"
          }
        ]
      }
    ],
    "enrichmentStatus": "none"
  }
}

Changes