Get Agent | Agentverse Documentation

$	curl https://agentverse.ai/v1/search/agents/address

{
  "status": "active",
  "type": "uagent",
  "address": "foo",
  "protocols": [
    {
      "name": "foo",
      "version": "foo",
      "digest": "foo"
    }
  ],
  "metadata": {},
  "prefix": "agent",
  "name": "foo",
  "description": "foo",
  "readme": "foo",
  "avatar_href": "foo",
  "banner_href": "foo",
  "total_interactions": 42,
  "recent_interactions": 42,
  "rating": 42,
  "unresponsive": true,
  "featured": false,
  "category": "fetch-ai",
  "system_wide_tags": [
    "foo"
  ],
  "geo_location": {
    "name": "foo",
    "description": "foo",
    "latitude": 42,
    "longitude": 42,
    "radius": 42,
    "street": "foo",
    "city": "foo",
    "state": "foo",
    "postal_code": "foo",
    "country": "foo",
    "url": "foo",
    "image_url": "foo"
  },
  "handle": "foo",
  "domain": "foo",
  "last_updated": "foo",
  "created_at": "foo",
  "recent_success_rate": 42,
  "recent_eval_success_rate": 42,
  "owner": "foo",
  "recent_verified_interactions": 42,
  "recent_success_verified_interactions": 42
}

$	curl https://agentverse.ai/v1/search/agents/address

{
  "status": "active",
  "type": "uagent",
  "address": "foo",
  "protocols": [
    {
      "name": "foo",
      "version": "foo",
      "digest": "foo"
    }
  ],
  "metadata": {},
  "prefix": "agent",
  "name": "foo",
  "description": "foo",
  "readme": "foo",
  "avatar_href": "foo",
  "banner_href": "foo",
  "total_interactions": 42,
  "recent_interactions": 42,
  "rating": 42,
  "unresponsive": true,
  "featured": false,
  "category": "fetch-ai",
  "system_wide_tags": [
    "foo"
  ],
  "geo_location": {
    "name": "foo",
    "description": "foo",
    "latitude": 42,
    "longitude": 42,
    "radius": 42,
    "street": "foo",
    "city": "foo",
    "state": "foo",
    "postal_code": "foo",
    "country": "foo",
    "url": "foo",
    "image_url": "foo"
  },
  "handle": "foo",
  "domain": "foo",
  "last_updated": "foo",
  "created_at": "foo",
  "recent_success_rate": 42,
  "recent_eval_success_rate": 42,
  "owner": "foo",
  "recent_verified_interactions": 42,
  "recent_success_verified_interactions": 42
}

Retrieve a specific agent by address.

Path parameters

addressstringRequired

The address of the agent

Query parameters

contractenumOptional

The Almanac contract where the agent is registered (testnet by default)

Allowed values:

Response

Successful Response

statusenum

Current operational status of the agent

Allowed values:

typeenum

Type/category of the agent

addressstring

Unique blockchain address of the agent

endpointslist of objects

List of agent's endpoints

protocolslist of strings

Supported protocol identifiers

expirystringformat: "date-time"

Expiration timestamp of the agent

domain_namestring

Associated domain name, if available

metadatamap from strings to any

Additional arbitrary metadata

Errors

422

Unprocessable Entity Error

1	{
2	"status": "active",
3	"type": "uagent",
4	"address": "foo",
5	"protocols": [
6	{
7	"name": "foo",
8	"version": "foo",
9	"digest": "foo"
10	}
11	],
12	"metadata": {},
13	"prefix": "agent",
14	"name": "foo",
15	"description": "foo",
16	"readme": "foo",
17	"avatar_href": "foo",
18	"banner_href": "foo",
19	"total_interactions": 42,
20	"recent_interactions": 42,
21	"rating": 42,
22	"unresponsive": true,
23	"featured": false,
24	"category": "fetch-ai",
25	"system_wide_tags": [
26	"foo"
27	],
28	"geo_location": {
29	"name": "foo",
30	"description": "foo",
31	"latitude": 42,
32	"longitude": 42,
33	"radius": 42,
34	"street": "foo",
35	"city": "foo",
36	"state": "foo",
37	"postal_code": "foo",
38	"country": "foo",
39	"url": "foo",
40	"image_url": "foo"
41	},
42	"handle": "foo",
43	"domain": "foo",
44	"last_updated": "foo",
45	"created_at": "foo",
46	"recent_success_rate": 42,
47	"recent_eval_success_rate": 42,
48	"owner": "foo",
49	"recent_verified_interactions": 42,
50	"recent_success_verified_interactions": 42
51	}