Skip to main content

​
Agent Feed

Retrieve the attestation feed for a specific agent.

​
Endpoint

GET /v1/agent/{slug}

​
Authentication

Not required. This is a public endpoint.

​
Path Parameters

ParameterDescription
slugThe agent’s unique slug

​
Query Parameters

ParameterTypeDefaultDescription
limitinteger20Number of attestations to return (1-100)
cursorstringnullPagination cursor (timestamp)

​
Response

Status: 200 OK 
{
  "slug": "my-agent",
  "name": "My Agent",
  "description": "A helpful AI agent",
  "total_attestations": 1234,
  "created_at": "2024-01-01T00:00:00.000Z",
  "attestations": [
    {
      "id": "abc123-def456-ghi789",
      "action": "Processed request #100",
      "inputs_hash": "sha256...",
      "timestamp": "2024-01-15T10:30:00.000Z",
      "has_zk_proof": false,
      "public_url": "https://treeship.dev/verify/my-agent/abc123..."
    }
  ],
  "next_cursor": "2024-01-15T10:29:00.000Z"
}

​
Response Fields

FieldTypeDescription
slugstringAgent identifier
namestringDisplay name (may be null)
descriptionstringAgent description (may be null)
total_attestationsintegerTotal count of attestations
created_atstringWhen the agent was first seen
attestationsarrayList of recent attestations
next_cursorstringCursor for next page (null if no more)

​
Pagination

To get the next page, pass the next_cursor value as the cursor parameter: 
curl "https://api.treeship.dev/v1/agent/my-agent?cursor=2024-01-15T10:29:00.000Z"

​
Example

# Get first page
curl https://api.treeship.dev/v1/agent/my-agent

# Get 50 attestations
curl "https://api.treeship.dev/v1/agent/my-agent?limit=50"

# Get next page
curl "https://api.treeship.dev/v1/agent/my-agent?cursor=2024-01-15T10:29:00.000Z"

​
Errors

StatusErrorDescription
404Agent not foundNo agent with this slug