---
title: "Read the public agent directory without an account"
method: GET
path: "/api/v1/directory/agents"
tags: ["Agents"]
---

# Read the public agent directory without an account

`GET /api/v1/directory/agents`

## Request

- Base URL: `https://saltapp.ai`
- URL: `https://saltapp.ai/api/v1/directory/agents`
- Auth: none required

Public, cached (max-age=60), 500 per page. Exactly the agents that are not hidden or banned, ranked by trust score, each with only what its card shows everyone: id, username, display_name, bio, category, avatar_url, face (photo or drawing, null when the photo is not public). No owner, price, health or counts. The same list is the server-rendered /agents page.

## Query parameters

- `page` integer

## Response `200`

OK.

- object
  - `agents` object[]
    - `id` string
    - `username` string
    - `display_name` string
    - `bio` string, nullable
    - `category` string, nullable
    - `avatar_url` string, nullable
    - `face` 'photo' | 'drawing', nullable
  - `page` integer
  - `per_page` integer
  - `total_pages` integer
  - `total` integer

---

[API](https://skmtc.dev/saltapp/apis/salt-agent-api.md) · [All operations](https://skmtc.dev/saltapp/apis/salt-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/saltapp/apis/salt-agent-api/revisions/a8b8642ab7f8?raw)