---
title: "List provider identities"
method: GET
path: "/provider/{provider}/identities"
tags: ["providers"]
---

# List provider identities

`GET /provider/{provider}/identities`

Get a list of identities available in a specific provider

## Path parameters

- `provider` string, required

## Query parameters

- `q` string

## Response `200`

Provider identities

- ModelsProviderIdentitiesResponse
  - `identities` object[]
    - `_id` string
    - `_reason` string
    - `_score` number
    - `_source` GithubComThandIoAgentInternalModelsIdentity
      - `group` GithubComThandIoAgentInternalModelsGroup
        - `email` string — Email is the email address associated with the group (e.g., a mailing list).
        - `id` string — ID is the unique identifier for the group.
        - `name` string — Name is the human-readable name of the group.
        - `parent` string — Parent is the ID of the parent group, if any.
      - `id` string — ID is the unique identifier for this identity. This will most likely be an email for users or a group name for groups. This will be used to tie identities across providers.
      - `label` string — Label is a human-readable name or description for this identity.
      - `providers` object — The providers this identity is associated with Format is map[provider_name]provider_type
      - `tenant` string — Tenant represents the tenant or organization this identity belongs to. This is useful for multi-tenant systems where identities are scoped to specific tenants.
      - `user` GithubComThandIoAgentInternalModelsUser
        - `email` string — Email is the user's email address, often used as a primary identifier.
        - `groups` string[] — Groups is a list of group names or IDs that this user belongs to.
        - `id` string — ID is the unique identifier for the user.
        - `name` string — Name is the user's full display name.
        - `source` string — Source identifies the identity provider or system where this user originated.
        - `username` string — Username is the user's login name or handle.
        - `verified` boolean — Verified indicates whether the user's identity has been verified.
  - `provider` string
  - `version` string

## Other responses

- `404` — Provider not found
- `500` — Internal server error

---

[API](https://skmtc.net/thand-io/apis/thand-agent-api.md) · [All operations](https://skmtc.net/thand-io/apis/thand-agent-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/thand-io/thand-agent-api/versions/62befb178368/schema)