---
title: "List actor mappings"
method: GET
path: "/v1/governance/actor-mappings"
tags: ["Governance"]
---

# List actor mappings

`GET /v1/governance/actor-mappings`

Lists actor mappings by actor ID with optional actor ID prefix filtering. Does not return display name or email.

## Query parameters

- `actorId` string — Actor ID prefix
- `cursor` string — Actor ID cursor
- `limit` integer — Page size (default 25, max 100)

## Response `200`

OK

- ActorMappingListResponse
  - `hasMore` boolean — True when more pages are available beyond this one
  - `items` ActorMappingListItemResponse[], nullable, required — PII-free actor mapping rows for the current page
    - `actorId` string, required — Opaque actor identifier; PII fields are omitted from list rows by design
    - `createdAt` string, required — Timestamp when the mapping was created, in RFC 3339 format (UTC)
    - `updatedAt` string, required — Timestamp when the mapping was last updated, in RFC 3339 format (UTC)
  - `limit` integer, required — Page size applied to this response
  - `nextCursor` string — Cursor to fetch the next page; empty when there are no more pages
  - `prevCursor` string — Cursor of the page that preceded this request; empty on the first page

## Other responses

- `default` — Error

---

[API](https://skmtc.net/lerian/apis/identity-plugin.md) · [All operations](https://skmtc.net/lerian/apis/identity-plugin/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lerian/identity-plugin/versions/25daba385532/schema)