---
title: "Get Images Endpoint"
method: GET
path: "/getImages"
---

# Get Images Endpoint

`GET /getImages`

## Request

- Base URL: `https://api.pavoot.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.pavoot.com/getImages`
- Auth: none declared

Endpoint for retrieving images with optional filters.
Note: aiQuery should be sent via POST /searchImages endpoint.

With idsOnly=true the response is {"imageIds": [...], "count": n, "total": n,
"truncated": bool, "limit": n} — every id the same filters would paginate through, capped
at MAX_SELECT_ALL_IDS.

## Query parameters

- `id` string, nullable
- `startDate` string, nullable
- `endDate` string, nullable
- `imageTitle` string, nullable
- `projectId` string, nullable
- `projectIds[]` string[]
- `photographerId` string, nullable
- `folderName` string, nullable
- `folderCategory` string, nullable
- `personCategory` string, nullable
- `personFieldValueId` string, nullable
- `tags` string[]
- `tagsByCategory` string, nullable
- `page` integer, nullable
- `pageSize` integer, nullable
- `dateTakenStart` string, nullable
- `dateTakenEnd` string, nullable
- `dateUploadedStart` string, nullable
- `dateUploadedEnd` string, nullable
- `filterTagsWithOr` boolean
- `sortBy` string, nullable
- `dateTakenNull` boolean, nullable
- `dateTakenInferred` boolean, nullable
- `idsOnly` boolean
- `includeFacets` boolean
- `visibleReasons[]` string[], nullable
- `showUnlocked` boolean

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-09-27** `89078ec5fa70`: 1 info
  - added the new optional `query` request parameter `dateTakenInferred`
- **2026-09-03** `21bae6010639`: 1 info
  - added the new optional `query` request parameter `includeFacets`

[Operation history](https://skmtc.dev/pavoot/apis/pavoot-api/changes/getImages/get.md)

---

[API](https://skmtc.dev/pavoot/apis/pavoot-api.md) - [All operations](https://skmtc.dev/pavoot/apis/pavoot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/pavoot/apis/pavoot-api/revisions/8c0cd91c2a05?raw)