---
title: "Retrieve the flags currently applied to a person"
method: GET
path: "/v1/persons/{personId}/flags"
tags: ["Persons"]
---

# Retrieve the flags currently applied to a person

`GET /v1/persons/{personId}/flags`

Retrieve all flags currently applied to a person, ordered newest first.

**Person flags differ from other entity flag endpoints** (e.g. Purchase Orders, Sales Opportunities): a person can have multiple flags active simultaneously, there is no single "current" flag, and there is no separate history endpoint — this list is the complete current state.

The `id` values returned are flag type IDs scoped to the `ContactUser` entity type. Use `GET /flags?entityType=ContactUser` (requires the `flags:read` scope) to discover valid flag IDs for this customer. (required scope contacts:persons:read)

## Path parameters

- `personId` string, uuid, required

## Query parameters

- `pageNumber` integer
- `pageSize` integer

## Headers

- `Customer-Id` integer, required

## Response `200`

OK

- PagedResponseReadFlagModel
  - `items` ReadFlagModel[]
    - `id` integer — The unique identifier of the flag
    - `name` string — The name of the flag
    - `description` string — The description of the flag
    - `color` string — The color associated with the flag
    - `createdAt` string, date-time — The UTC timestamp of when this flag was created
  - `pageNumber` integer
  - `pageSize` integer
  - `totalItemCount` integer

## Other responses

- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/bigchange/apis/bigchange-dx.md) · [All operations](https://skmtc.net/bigchange/apis/bigchange-dx/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bigchange/bigchange-dx/revisions/916e669fc527/schema)