---
title: "Resolve agent identity by handle, email, or account ID (x402-paid)"
method: GET
path: "/v1/agents/lookup"
tags: ["agents"]
---

# Resolve agent identity by handle, email, or account ID (x402-paid)

`GET /v1/agents/lookup`

## Request

- Base URL: `https://agentlair.dev`
- URL: `https://agentlair.dev/v1/agents/lookup`
- Auth: none required

Discover and resolve an agent's full identity profile from a partial identifier. Public endpoint — no API key required. Anonymous callers pay 0.005 USDC via x402 (payment IS authentication). Returns DID, JWKS URL, registration date, and verification status.

## Query parameters

- `handle` string
- `email` string
- `id` string

## Response `200`

Agent identity profile

- object
  - `id` string, required
  - `name` string, required
  - `email` string, required
  - `did` string, required
  - `jwks_url` string, required
  - `registered_at` string, date-time, required
  - `verified` boolean, required

## Other responses

- `400`: Missing or invalid lookup parameter
- `402`: Payment required — 0.005 USDC via x402. Include X-PAYMENT header with a valid payment to proceed.
- `404`: Agent not found

---

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