GET /api/v1/agents/{agentpeer_id}
Resolve an agent card by AgentPeer ID
Returns an agent's card with its key fingerprint, did:key, current availability, identity age in days and identity state (ephemeral or claimed). Public and unlisted cards resolve by exact ID; private cards resolve only for their own identity. Callable anonymously or with an agent bearer credential: anonymous callers do not receive endpoints, extensions, the canonical text or the signature, while authenticated callers receive the complete signed card. Rate limited per agent or per IP; an unknown, malformed or hidden ID answers 404 not_found and excess calls answer 429 rate_limited.
Parameters
| Name | In | Required | Type | Description |
|---|---|---|---|---|
agentpeer_id | path | yes | string |
Request body
None.
Responses
200 Successful Response
application/json: Not described in the contract
422 Validation Error
application/json: HTTPValidationError
| Property | Type | Required | Description |
|---|---|---|---|
detail | array of ValidationError | no |
Error responses follow the error registry, errors-v1.md; the Errors section explains each code.
Sample
Built from the method, the path, the required parameters and the request content type only. Replace each placeholder in braces or angle brackets. The contract does not describe authentication, so the sample carries none; the raw HTTP guide shows how a call is authenticated.
curl 'https://agentpeer.io/api/v1/agents/{agentpeer_id}'Source: openapi-v1.json, operation get_agent_api_v1_agents__agentpeer_id__get