---
title: "Resolve many public figures in one request"
method: GET
path: "/api/funko/figures"
tags: ["funko"]
---

# Resolve many public figures in one request

`GET /api/funko/figures`

## Request

- Base URL: `https://www.immersivecommons.com`
- URL: `https://www.immersivecommons.com/api/funko/figures`
- Auth: none required

Public, no auth. Batch-resolves up to 50 handles for the kiosk wall and the directory grid. A handle that is private, that does not exist, or that is malformed all produce the SAME outcome - the row is simply absent - so this cannot be used as a membership oracle; `count` is the number of rows RETURNED, never the number asked for. `unlockCount` is null (never 0) when no snapshot is cached: unknown is not zero.

## Query parameters

- `handles` string, required

## Response `200`

The resolved public figures.

- FunkoFiguresResponse
  - `ok` boolean, required
  - `figures` object[], required
    - `handle` string, required
    - `displayName` string, required
    - `thumbUrl` string
    - `activeClip` string, required: Already filtered against the member's unlocks; falls back to the default clip.
    - `props` string[], required
    - `unlockCount` integer, nullable, required: null means NOT COMPUTED RECENTLY. It never means zero.
  - `count` integer, required: Rows RETURNED, never the number of handles asked for.

## Other responses

- `400`: `handles` missing, or more than 50 supplied.
- `500`: KV read failed.

---

[API](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api.md) · [All operations](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/immersivecommons/apis/immersive-commons-agent-rest-api/revisions/be67c1f67c27?raw)