---
title: "Get person by ID"
method: GET
path: "/people/{id}"
tags: ["People"]
---

# Get person by ID

`GET /people/{id}`

## Request

- Base URL: `https://api.prometiam.com/functions/v1/risk-api`
- URL: `https://api.prometiam.com/functions/v1/risk-api/people/{id}`
- Auth: HTTP bearer

Fetch a single person (officer / director) by numeric ID. Returns full name, NIF (if available), and a list of all known company appointments — past and current.

## Path parameters

- `id` integer, required

## Query parameters

- `appointments_limit` integer
- `appointments_offset` integer

## Response `200`

Person detail

- object
  - `data` Person
    - `id` integer
    - `match_score` integer, nullable: Relevance/confidence of the fuzzy name match, 0–100 (pg_trgm similarity × 100). Results are ranked by this score, best first.
    - `full_name` string
    - `nif` string, nullable
    - `is_legal_entity` boolean
    - `first_seen_date` string, date, nullable
    - `last_seen_date` string, date, nullable
    - `appointments` Appointment[]
      - `id` integer
      - `person_id` integer
      - `company_id` integer, nullable
      - `company_name` string, nullable
      - `company_number` string, nullable
      - `full_name` string, nullable
      - `role` string, nullable
      - `appointment_date` string, date, nullable: Norway appointments carry no dates: the Brønnøysund roles file publishes current roles without appointment dates, so date fields are null for NO.
      - `end_date` string, date, nullable
      - `is_current` boolean: Boolean. Whether the officer is still in office: true when the appointment has no end date and no ending action (resignation, cessation), false otherwise. Appointments are returned for Spain, France, the United Kingdom and Norway only; false when the appointment has an end date (ceased_date) or its action records the end (ceased, resigned). One rule for every country; Norway's roles file carries no end dates, so a Norwegian role reads current until the register drops it.
    - `created_at` string, date-time

## Other responses

- `401`: Missing, invalid, or expired API key
- `403`: Key lacks the required scope or country access
- `404`: Record or endpoint not found
- `429`: Rate limit exceeded — see `Retry-After` header for seconds until reset

---

[API](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api.md) · [All operations](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/prometiam/apis/prometiam-risk-intelligence-api/revisions/b01703443e4e?raw)