---
title: "Canonical record by handle or id"
method: GET
path: "/agents/{id}"
tags: ["records"]
---

# Canonical record by handle or id

`GET /agents/{id}`

## Request

- Base URL: `https://wellknown.network/api/v1`
- URL: `https://wellknown.network/api/v1/agents/{id}`
- Auth: one of:
  - none
  - HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

OK

- AgentRecord: See /docs/records. Blocks: declared, derived, observed, verification, provenance.
  - `$schema` string
  - `id` string
  - `handle` string
  - `url` string
  - `kind` string
  - `declared` object
  - `derived` object
  - `observed` object
  - `verification` object
  - `provenance` object
  - `firstSeenAt` string, date-time
  - `updatedAt` string, date-time

## Other responses

- `404`: Error

---

[API](https://skmtc.dev/wellknown/apis/wellknown-api.md) · [All operations](https://skmtc.dev/wellknown/apis/wellknown-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wellknown/apis/wellknown-api/revisions/8a177fdcd434?raw)