---
title: "getPerson"
method: GET
path: "/people/{pguid}"
tags: ["people"]
---

# getPerson

`GET /people/{pguid}`

This method returns the information of a person, given its PGUID.

## Path parameters

- `pguid` string, required

## Query parameters

- `personFields` string[]
- `biometricFields` string[]
- `biographicBase` boolean

## Response `200`

OK

- GetPeopleResponse
  - `data` Person
    - `pguid` string — Global unique ID of the Person. This attribute is assigned by the AFIS once the person is successfully enrolled
    - `lastEnrollTguid` string — Global unique ID of the latest transaction on this Person.
    - `timestamp` integer — Timestamp of the latest transaction on this Person.
    - `keys` Key[]
      - `id` string — Name of entity identifier.
      - `value` string — Value of entity identifier.
    - `biographics` Biographic[]
      - `key` string — Biographic key.
      - `type` 'TEXT' | 'FACE' — Biographic type. It can be TEXT or FACE.
      - `value` string — Biographic value. Faces are encoded in Base64.
    - `biometric` Biometric[]
      - `index` integer
      - `content` string
      - `width` integer
      - `height` integer
      - `resolution` integer
    - `auxiliaries` Biometric[]
      - `index` integer
      - `content` string
      - `width` integer
      - `height` integer
      - `resolution` integer
    - `metadata` string[] — Arbitrary data associated with the person.
    - `labels` string[] — Arbitrary labels associated with a person, which can be used as filters for database queries.
    - `history` History
      - `events` HistoryEvent[]
        - `tguid` string
        - `timestamp` string, date-time
        - `type` 'ENROLL' | 'UPDATE' | 'DISABLE_TRANSACTION' | 'DELETE_BIOMETRIC' | 'INCORRECT_ENROLL_TREATMENT'
    - `biographicBaseStatus` 'UNAVAILABLE' | 'TIMEOUT' | 'UNAUTHORIZED' | 'INVALID_DATA' | 'NOT_FOUND' | 'OK' — Status of the biographic base. - `UNAVAILABLE`: When all Biobase Servers are off. - `TIMEOUT`: When at least one Biobase Server is ON but the call timed out. - `UNAUTHORIZED`: - If the **lookAllServers** conf is **ON**, it indicates that all running servers returned that the API authentication is unauthorized. - If the **lookAllServers** conf is **OFF**, it indicates that the server that received the biographic request returned that the API authentication is unauthorized. - `INVALID_DATA`: The Biobase Server returned that the data request from the API is invalid. It is not supposed to happen if Biobase Server is implemented according to the Biographic Base API. - `NOT_FOUND`: - If the **lookAllServers** conf is **ON**, it indicates that the person keys were not found on all Biobase Servers configured. - If the **lookAllServers** conf is **OFF**, it indicates that person keys were not found on the server that received the biographic request. - `OK`: The Biobase Server returned biographics/face for the given person keys.

## Other responses

- `400` — Validation Error
- `404` — Person does not exist
- `500` — Internal Error

---

[API](https://skmtc.net/griaule/apis/gbds-api.md) · [All operations](https://skmtc.net/griaule/apis/gbds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/griaule/gbds-api/versions/fa80f482ec5e/schema)