API ReferenceAgents
Get an agent
Returns the current published version, supported outputs, data policy, and rate card for one agent.
Authorization
bearerAuth AuthorizationBearer <token>
Send a SimpleServe API key as Authorization: Bearer <key>.
In: header
Path Parameters
namespace*string
Supplier namespace from the namespaced agent ID.
Match
^[a-z0-9]+(?:-[a-z0-9]+)*$slug*string
Agent slug from the namespaced agent ID.
Match
^[a-z0-9]+(?:-[a-z0-9]+)*$Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/agents/acme/construction-researcher"{ "id": "acme/construction-researcher", "object": "agent", "name": "Construction Researcher", "description": "Finds and summarizes commercial construction projects from Acme data.", "provider": { "id": "acme", "name": "Acme Data", "verified": true, "website": "https://example.com" }, "version": "2026-08-01", "status": "available", "categories": [ "construction", "project-research" ], "input": { "text": true, "files": false, "accepted_media_types": [] }, "output_types": [ "text", "file", "data" ], "pricing": { "id": "rc_2026_08", "currency": "USD", "minimum_cost_usd": 1.075, "maximum_cost_usd": 2.15, "network_fee_percentage": 7.5, "meters": [ { "id": "invocations", "unit": "invocation", "price_usd": 1, "description": "One started research request." }, { "id": "returned_records", "unit": "record", "price_usd": 0.01, "description": "One project record returned in the final result." } ] }, "data_policy": { "retention": "none", "retention_days": null, "training": false, "policy_url": "https://example.com/privacy" }, "updated_at": "2026-08-29T18:00:00Z"}