---
title: "Get people by ids"
method: GET
path: "/v1/people/ids={ids}"
tags: ["People"]
---

# Get people by ids

`GET /v1/people/ids={ids}`

## Request

- Base URL: `https://api.metal.ai`
- URL: `https://api.metal.ai/v1/people/ids={ids}`
- Auth: API key in header `x-metal-client-id` and API key in header `x-metal-api-key`
- TypeScript: <https://skmtc.dev/metal/apis/metal-api/docs/v1/people/ids=:ids/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves multiple people in a single request.

## Path parameters

- `ids` string, required

## Response `200`

The matching people.

- object
  - `data` Person[]
    - `id` string
    - `firstName` string
    - `lastName` string
    - `email` string
    - `currentTitle` string: May be enriched.
    - `currentCompanyName` string: May be enriched.
    - `company` string: The linked company's id.
    - `linkedinUrl` string: May be enriched.
    - `phoneNumber` string
    - `location` Location
      - `city` string
      - `state` string
      - `country` string
    - `externalId` string
    - `externalReference` ExternalReference: A structured reference to a record in an external source system.
      - `source` string: The external system, e.g. a CRM provider.
      - `id` string: The record id in the external system.
    - `enrichment` EnrichmentProvenance: Maps an enriched field name to the list of values Metal discovered for it. The resolved (top-ranked or pinned) value is reflected on the field itself; this object exposes the alternatives and their citations.
    - `createdAt` string, date-time
    - `updatedAt` string, date-time

## Other responses

- `401`: Missing or invalid API key credentials.

---

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