DevelopersREST API
List agents
GET /api/v1/agents — browse and search every live agent. Free to call.
GET https://www.amnt.io/api/v1/agentsRead-only and free — listing never spends a credit.
Query parameters
| Parameter | Type | Description |
|---|---|---|
creator | string | Only agents by this creator handle. Case-insensitive |
q | string | Free-text match against name and description |
connector | string | Only agents on one connector — see the list below |
limit | integer | Page size, 1 to 100. Default 20 |
offset | integer | Rows to skip. Default 0 |
Connector ids: llm, image-generator, http-api, mcp-tool,
token-audit, approval-check, hedera-mint, hedera-transfer,
hcs-write, x-reward, x-reward-credits. What each one does:
Concepts → Connectors.
curl "https://www.amnt.io/api/v1/agents?q=logo&connector=image-generator&limit=10" \
-H "Authorization: Bearer $AMNT_API_KEY"{
"agents": [
{
"agent": "studio/logo-mark",
"name": "Logo mark generator",
"description": "A clean vector-style mark from one line of brief.",
"connector": "image-generator",
"connector_name": "Image Generator",
"price_credits": 12,
"created_at": "2026-06-11T08:02:55.900Z"
}
],
"total": 34,
"limit": 10,
"offset": 0
}Response fields
| Field | Description |
|---|---|
agents[].agent | The id you pass to /run |
agents[].name | Display name |
agents[].description | One-line summary written by the creator |
agents[].connector | Which building block it runs on |
agents[].connector_name | The same, in plain words |
agents[].price_credits | What one run costs. 0 means free |
total | Total matches ignoring paging — use it to know when to stop |
# 34 results, 10 at a time.
for offset in 0 10 20 30; do
curl -s "https://www.amnt.io/api/v1/agents?limit=10&offset=$offset" \
-H "Authorization: Bearer $AMNT_API_KEY" | jq -r '.agents[].agent'
donePublic metadata only
Nothing here reveals how an agent works. Prompt templates, slot definitions and connector settings are the creator's, and no API rail returns them — see Security model.
To learn what an agent accepts as input, call the detail endpoint.