---
title: "List External Identities for an Actor"
method: GET
path: "/actors/{actor_id}/external_identities"
tags: ["External Identities"]
---

# List External Identities for an Actor

`GET /actors/{actor_id}/external_identities`

## Path parameters

- `actor_id` string, required

## Query parameters

- `limit` integer
- `page_cursor` string

## Response `200`

ExternalIdentity List Response

- ExternalIdentityListResponse — Response schema for multiple External Identities
  - `data` ExternalIdentity[] — External Identity details
    - `account_id` string, uuid — Account ID
    - `actor_id` string, uuid, required — Actor ID
    - `directory_id` string, uuid — Directory UUID reference
    - `family_name` string — Family name
    - `firezone_avatar_url` string — Firezone-hosted avatar URL
    - `given_name` string — Given name
    - `id` string, uuid, required — External Identity ID
    - `idp_id` string, required — IDP-specific identifier for this identity
    - `inserted_at` string, date-time — Creation timestamp
    - `issuer` string, required — Identity issuer URL (e.g., 'https://accounts.google.com', 'https://company.okta.com')
    - `middle_name` string — Middle name
    - `name` string — Full name
    - `nickname` string — Nickname
    - `picture` string — Profile picture URL
    - `preferred_username` string — Preferred username
    - `profile` string — Profile URL
    - `synced_at` string, date-time — Last sync timestamp
  - `metadata` PaginationMetadata — Pagination metadata for paginated responses.
    - `count` integer, required — Total number of matching records
    - `limit` integer, required — Page size
    - `next_page` string, nullable, required — Cursor to fetch the next page
    - `prev_page` string, nullable, required — Cursor to fetch the previous page

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Too Many Requests

---

[API](https://skmtc.dev/firezone/apis/firezone-api.md) · [All operations](https://skmtc.dev/firezone/apis/firezone-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/firezone/firezone-api/revisions/110de2cb2283/schema)