KyroKyro Docs
ReferenceAPI Reference

Get a Kyro profile summary by username

GET
/api/v1/profile/{username}

Returns a curated public summary of a registered Kyro identity: wallet, display name, score, risk level, activity totals, attestation count and a compact trust summary. Costs 1 rate unit.

Authorization

bearerApiKey
AuthorizationBearer <token>

Optional Kyro API key: Authorization: Bearer kyro_live_.... Anonymous access (no header) works on every endpoint with a lower rate limit (20 units/minute per IP vs 120 units/minute per key). Keys are validated only when the header is present; a malformed, unknown or revoked key is rejected with 401 INVALID_KEY.

In: header

Path Parameters

username*string

Kyro username, e.g. yourname.kyro. At least 2 characters.

Length2 <= length

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/api/v1/profile/amara.kyro"
{  "ok": true,  "version": "v1",  "data": {    "username": "amara.kyro",    "wallet": "0x7c3ed42f1a95b60b1cf34ab6c58f22d09ce8a1b4",    "displayName": "amara.kyro",    "createdAt": "2026-03-02T18:11:40.000Z",    "score": 72,    "scoreModelVersion": "identity_score_v1",    "riskLevel": "Reliable",    "globalWalletAgeDays": 1460,    "activeChainCount": 3,    "totalTxCount": 2417,    "scoreUpdatedAt": "2026-08-09T07:52:13.000Z",    "dataSource": "cached",    "attestations": {      "count": 6    },    "trust": {      "trustedPeerCount": 4,      "reciprocalCount": 2,      "networkHealth": "healthy",      "trustConfidence": 0.62    }  }}