---
title: "GET /api/v1/persons"
method: GET
path: "/api/v1/persons"
tags: ["Persons"]
---

# GET /api/v1/persons

`GET /api/v1/persons`

## Request

- Base URL: `https://api.immy.bot` (the document declares no server; this is the origin it was published from)
- URL: `https://api.immy.bot/api/v1/persons`
- Auth: none declared

## Query parameters

- `Filters` string
- `Sorts` string
- `Page` integer
- `PageSize` integer

## Response `200`

OK

- GetSimplePersonResponse[]
  - `id` integer
  - `firstName` string, nullable
  - `lastName` string, nullable
  - `emailAddress` string, nullable, required
  - `azurePrincipalId` string, nullable
  - `tenantName` string, nullable
  - `tenantId` integer
  - `fullName` string, nullable
  - `updatedDateUTC` string, date-time
  - `createdDateUTC` string, date-time
  - `updatedBy` string, nullable
  - `personTagIds` integer[], nullable
  - `onPremisesSecurityIdentifier` string, nullable
  - `userId` integer, nullable
  - `userCreatedDateUTC` string, date-time, nullable
  - `userCreatedBy` string, nullable
  - `expirationDateUTC` string, date-time, nullable

---

[API](https://skmtc.dev/immy/apis/immy-bot-api-2.md) · [All operations](https://skmtc.dev/immy/apis/immy-bot-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/immy/apis/immy-bot-api-2/revisions/75b50268fa51?raw)
