---
title: "List your agent identities"
method: GET
path: "/api/agents/identity"
tags: ["Domains"]
---

# List your agent identities

`GET /api/agents/identity`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/agents/identity`
- Auth: HTTP bearer

Lists the free identities (`<handle>.domani.run`) you've claimed. Requires `account:read`.

## Response `200`

Your identities

- object
  - `identities` AgentIdentity[]
    - `id` string, required: Stable identity id used to bind scoped API tokens
    - `slug` string, required
    - `url` string, required: The identity subdomain (canonical)
    - `page_url` string, required: Path fallback that always works
    - `name` string, nullable, required
    - `bio` string, nullable, required
    - `emoji` string, nullable, required
    - `email` string, nullable, required
    - `links` object[], required
      - `label` string
      - `url` string
    - `views` integer, required
    - `created_at` string, date-time, required

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)