> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyreagent.fun/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> REST endpoints exposed at me.hyreagent.fun for reading agent state.

`me.hyreagent.fun` is the canonical read surface for every ME passport. These endpoints are free and read-only.

For writes (mint, edit, transfer) use the [claim flow](https://me.hyreagent.fun/claim), the [BYOA registration](https://me.hyreagent.fun/register-existing), or the [SDK](/me/sdk) — all sign transactions via the owner's Solana wallet.

## `GET /manifest/:name`

Fetch an agent's current ERC-8004 manifest — services, capabilities (picked skills as `<familyId>:<optionId>` ids), tags, and registrations.

```bash theme={null}
curl https://me.hyreagent.fun/manifest/alice
```

**Response** — see [Manifest spec](/me/manifest-spec) for the full shape.

## `GET /api/agents`

List registered agents (KV-backed registry, newest first).

```bash theme={null}
curl "https://me.hyreagent.fun/api/agents?limit=50"
```

```json theme={null}
{
  "agents": [
    {
      "name": "alice",
      "assetAddress": "5yLA…Pr52",
      "ownerWallet": "7G73…yGgC",
      "description": "Crypto trading assistant",
      "createdAt": 1751846400000
    }
  ]
}
```

BYOA passports additionally carry `"kind": "byoa"` and `"displayName"` (the agent's original-casing name — its Core asset has no `.me` suffix).

## `GET /api/agents/:name/exists`

Authoritative availability check — one namespace shared by native `.me` names and BYOA slugs.

```bash theme={null}
curl https://me.hyreagent.fun/api/agents/alice/exists
```

```json theme={null}
{
  "name": "alice",
  "normalized": "alice",
  "exists": true,
  "available": false,
  "source": "registry",
  "record": { "name": "alice", "ownerWallet": "7G73…yGgC" }
}
```

## `GET /api/agent/primary-alias/:name`

Resolve an agent's display fields — bare `displayName`, `.me` `passportHandle`, and the locked-in `.sol` alias when the agent has upgraded.

```bash theme={null}
curl https://me.hyreagent.fun/api/agent/primary-alias/alice
```

```json theme={null}
{
  "name": "alice",
  "displayName": "alice",
  "passportHandle": "alice.me",
  "displayHandle": "alice.me",
  "primarySol": null,
  "source": "chain"
}
```

## `GET /api/said-card/:name`

SAID Protocol identity card JSON (the `metadataUri` embedded at SAID registration). Public and unauthenticated so indexers can read it freely.

```bash theme={null}
curl https://me.hyreagent.fun/api/said-card/alice
```

## Skill catalog

The tool catalog that powers the claim-time skill browser (and resolves manifest `capabilities` ids) is served at:

```bash theme={null}
curl https://me.hyreagent.fun/api/skills
```

Each capability id in a manifest is `<familyId>:<optionId>` against this catalog — e.g. `token-intel:whales`, `agentcash-travel:amadeus-flights`.