---
title: "People"
method: GET
path: "/v1/people/all"
tags: ["v1"]
---

# People

`GET /v1/people/all`

Search and retrieve additional information on known persons that exist within Perigon's entity database and as referenced in any article response object. Our database contains over 650,000 people from around the world and is refreshed frequently. People data is derived from Wikidata and includes a wikidataId field that can be used to lookup even more information on Wikidata's website.

## Query parameters

- `name` string
- `wikidataId` string[]
- `occupationId` string[]
- `occupationLabel` string
- `page` integer
- `size` integer

## Response `200`

200 - Success

- PeopleSearchResult — Person search result
  - `status` integer, required
  - `numResults` integer, required
  - `results` Person[], required
    - `wikidataId` string, nullable
    - `createdAt` string, nullable
    - `updatedAt` string, nullable
    - `name` string, nullable
    - `gender` WikidataLabelHolder
      - `wikidataId` string, nullable
      - `label` string, nullable
    - `dateOfBirth` WikidataDateHolder
      - `time` string, nullable
      - `precision` string, nullable
    - `dateOfDeath` WikidataDateHolder
      - `time` string, nullable
      - `precision` string, nullable
    - `description` string, nullable
    - `aliases` string[], nullable
    - `occupation` WikidataLabelHolder[], nullable
      - `wikidataId` string, nullable
      - `label` string, nullable
    - `position` WikidataPositionHolder[], nullable
      - `wikidataId` string, nullable
      - `label` string, nullable
      - `startTime` WikidataDateHolder
        - `time` string, nullable
        - `precision` string, nullable
      - `endTime` WikidataDateHolder
        - `time` string, nullable
        - `precision` string, nullable
      - `employer` WikidataLabelHolder
        - `wikidataId` string, nullable
        - `label` string, nullable
    - `politicalParty` WikidataPoliticalPartyHolder[], nullable
      - `wikidataId` string, nullable
      - `label` string, nullable
      - `startTime` WikidataDateHolder
        - `time` string, nullable
        - `precision` string, nullable
      - `endTime` WikidataDateHolder
        - `time` string, nullable
        - `precision` string, nullable
    - `image` ImageHolder
      - `url` string, nullable
    - `abstract` string, nullable

## Other responses

- `400` — 400 - Bad Request
- `401` — 401 - Invalid API Key
- `403` — 403 - Request Forbidden
- `429` — 429 - Too Many Requests
- `500` — 500 - Server Error

## Changes

- **2025-08-18** `a73a3b58ca66` — 1 breaking, 22 warning, 78 info
  - the `status` response's property type/format changed from `string`/`` to `integer`/`int32` for status `429`
  - removed the optional property `cause` from the response with the `400` status
  - removed the optional property `cause` from the response with the `401` status
  - removed the optional property `cause` from the response with the `403` status
  - …97 more
- **2025-08-04** `3eb8ae4622b8` — 18 breaking, 17 warning, 9 info
  - the response property `results/items/dateOfBirth` became nullable for the status `200`
  - the response property `results/items/dateOfDeath` became nullable for the status `200`
  - the response property `results/items/gender` became nullable for the status `200`
  - the response property `results/items/image` became nullable for the status `200`
  - …40 more
- **2025-07-31** `556127fafa6a` — 1 info
  - api tag `Supplemental Endpoints` removed
- **2025-06-04** `52b02cb25532` — 1 info
  - api tag `Supplemental Endpoints` added
- **2025-05-08** `ae72ecd67fb1` — 3 info
  - the response property `numResults` became required for the status `200`
  - the response property `results` became required for the status `200`
  - the response property `status` became required for the status `200`

[Change history](https://skmtc.dev/goperigon/apis/perigon-api/changes/v1/people/all/get.md)

---

[API](https://skmtc.dev/goperigon/apis/perigon-api.md) · [All operations](https://skmtc.dev/goperigon/apis/perigon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goperigon/perigon-api/revisions/2c55bf07003a/schema)