---
title: "Lookup Users"
method: POST
path: "/api/platform/users/lookup"
tags: ["platform"]
---

# Lookup Users

`POST /api/platform/users/lookup`

Resolve Auth0 identity fields for a set of ``user_id`` values.

Used by scope member panels that only store principal ids from FGA and
need human-readable labels without paging the full tenant listing.

## Request body

- UsersLookupRequest — Batch identity lookup for Auth0 users referenced by id elsewhere in the UI.
  - `userIds` string[]

## Response `200`

Successful Response

- UsersLookupResponse — Resolved Auth0 users for the principal ids in the request. Each item's ``userId`` matches the requested FGA principal id, which may differ from Auth0's canonical id when identities were linked or aliased.
  - `items` User[]
    - `userId` string, required
    - `email` string, nullable
    - `name` string, nullable
    - `picture` string, nullable
    - `loginCount` integer
    - `lastLogin` string, nullable
    - `createdAt` string, nullable
    - `linkedSubs` string[]

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/gocrisp/apis/crisp-app-dock.md) · [All operations](https://skmtc.dev/gocrisp/apis/crisp-app-dock/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gocrisp/crisp-app-dock/revisions/e56bd3c1a9db/schema)