Agents

The A2A agent registry

GET

https://apis.io/api/v1

/agents

Agents that registered themselves by serving an agent card and calling POST /agents/register. Each row carries the card URL, the operator, and the last verification of the card - grade against A2A 1.0.0, protocol version, preferred transport, deviations. Free and keyless; this is the one door on this API an unattended agent can walk through unaided.

The A2A agent registry › query Parameters

page

integer · min: 1 · max: 1000000

1-based page number.

Default: 1

limit

integer · min: 1 · max: 100

Items per page.

Default: 25

The A2A agent registry › Responses

200

The registry, newest registration first.

object

object[]

register

string

Path of the registration endpoint.

registry

string · uri

The human-readable registry page.

note

string

GET/agents

curl https://apis.io/api/v1/agents \
  --header 'X-API-Key: <api-key>'

Example Responses

{
  "meta": {},
  "data": [
    {
      "slug": "slug",
      "name": "name",
      "operator": "operator",
      "operator_url": "operator_url",
      "card_url": "https://www.example.com/path/to/resource",
      "registered": "2024-08-25",
      "registered_via": "registered_via",
      "provider_slug": "provider_slug",
      "grade": "grade",
      "last_checked": "2024-08-25",
      "serving": true,
      "protocol_version": "protocol_version",
      "preferred_transport": "preferred_transport",
      "deviations": [
        "string"
      ],
      "_type": "agent"
    }
  ],
  "register": "register",
  "registry": "https://www.example.com/path/to/resource",
  "note": "note"
}

json

application/json

How to register an agent - the endpoint describes itself

GET

https://apis.io/api/v1

/agents/register

A bare GET returns the registration contract - the endpoint, the body, the gate and the responses - so an agent that lands here without documentation can proceed. Free and keyless.

How to register an agent - the endpoint describes itself › Responses

200

The registration contract.

Register an agent - the machine door

POST

https://apis.io/api/v1

/agents/register

Free and keyless. Serve an A2A agent card at /.well-known/agent-card.json on a host you control, then pass its URL (or just the host). The card must be fetchable and pass the three A2A 1.0.0 hard checks: capabilities is an object, protocolVersion is present, skills is an array. The card is the evidence, so there is no account and no form. 202 queues the registration for review; 422 names the check that failed.

Register an agent - the machine door › Request Body

card_url

string · required

The agent card URL or the host that serves one at a well-known path.

operator

string

Optional: who runs the agent.

contact

string

Optional: an email for questions about the registration.

Register an agent - the machine door › Responses

Queued for review. The body carries the graded card and the queue status.

Countries Feedback

APIs.io API

Agents

The A2A agent registry

GET

https://apis.io/api/v1

/agents

The A2A agent registry › query Parameters

page

integer · min: 1 · max: 1000000

1-based page number.

Default: 1

limit

integer · min: 1 · max: 100

Items per page.

Default: 25

The A2A agent registry › Responses

200

The registry, newest registration first.

object

object[]

register

string

Path of the registration endpoint.

registry

string · uri

The human-readable registry page.

note

string

GET/agents

curl https://apis.io/api/v1/agents \
  --header 'X-API-Key: <api-key>'

Example Responses

{
  "meta": {},
  "data": [
    {
      "slug": "slug",
      "name": "name",
      "operator": "operator",
      "operator_url": "operator_url",
      "card_url": "https://www.example.com/path/to/resource",
      "registered": "2024-08-25",
      "registered_via": "registered_via",
      "provider_slug": "provider_slug",
      "grade": "grade",
      "last_checked": "2024-08-25",
      "serving": true,
      "protocol_version": "protocol_version",
      "preferred_transport": "preferred_transport",
      "deviations": [
        "string"
      ],
      "_type": "agent"
    }
  ],
  "register": "register",
  "registry": "https://www.example.com/path/to/resource",
  "note": "note"
}

json

application/json

How to register an agent - the endpoint describes itself

GET

https://apis.io/api/v1

/agents/register

A bare GET returns the registration contract - the endpoint, the body, the gate and the responses - so an agent that lands here without documentation can proceed. Free and keyless.

How to register an agent - the endpoint describes itself › Responses

200

The registration contract.

Register an agent - the machine door

POST

https://apis.io/api/v1

/agents/register

Register an agent - the machine door › Request Body

card_url

string · required

The agent card URL or the host that serves one at a well-known path.

operator

string

Optional: who runs the agent.

contact

string

Optional: an email for questions about the registration.

Register an agent - the machine door › Responses

Queued for review. The body carries the graded card and the queue status.

Countries Feedback