---
title: "Get current agent profile"
method: GET
path: "/v1/me"
tags: ["agent"]
---

# Get current agent profile

`GET /v1/me`

## Request

- Base URL: `https://api.lithtrix.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.lithtrix.ai/v1/me`
- Auth: none declared

Returns profile fields for the Bearer-authenticated agent (name, owner, tier, limits).

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- MeResponse: Authenticated agent profile for ``GET /v1/me`` (Bearer key only; not a public route).
  - `agent_id` string, required
  - `agent_name` string, required
  - `owner_identifier` string, required: Echo of the registered owner contact. Visible only to this agent's key; never included on unauthenticated public agent routes.
  - `tier` string, required
  - `monthly_limit` integer, required
  - `status` string, required
  - `created_at` string, required
  - `referral_agent` string, nullable: UUID of the referring agent, if this agent registered with `referral_agent`.
  - `referral_code` string, required: This agent's UUID — share as `referral_agent` when others register.
  - `trust_tier` string, required: Progressive trust: ``probationary`` or ``standard``.
  - `trust_calendar_days_since_registration` integer, required: Whole UTC calendar days since ``agents.created_at``.
  - `trust_calendar_days_remaining_until_standard_by_age` integer, required: ``max(0, 7 - trust_calendar_days_since_registration)`` while probationary; 0 otherwise.
  - `trust_successful_calls_since_first_call` integer, nullable: Count of ``usage_logs`` rows at/after ``first_call_at`` (None until first Bearer use).
  - `trust_successful_calls_remaining_until_standard` integer, nullable: Calls remaining toward the 50-call promotion gate (None when standard or gate N/A).
  - `trust_promotion_calls_gate_requires_first_call_at` boolean, required: True until ``first_call_at`` is set — call-count promotion unavailable until then.
  - `trust_promotion_standard_requires_calls_total` integer, required: Successful API calls required after ``first_call_at`` for call-based promotion.
  - `trust_promotion_standard_requires_calendar_days_since_registration` integer, required: UTC calendar days since registration for age-based promotion.
  - `trust_tier_unlocks` object, required: Capability unlock booleans/limits for the authenticated trust tier (same matrix as ``capabilities.trust_tiers.unlocks`` on GET /v1/capabilities).
  - `frozen_at` string, nullable: UTC timestamp when this agent invoked POST /v1/me/freeze; null when not frozen. Irreversible via API v1.
  - `passport_present` boolean, required: True when this agent has an **active** (``revoked_at`` IS NULL) ``agent_passports`` row. No private passport material is returned here.
  - `passport_capabilities` PassportCapabilityPublicBlock: Split capability surface returned on passports and GET /v1/me (D88 — never fuse with verified).
    - `verified` string[], required: Lithtrix-derived lithtrix:* capability URIs (scoped keys + tier).
    - `self_reported` string[], required: Operator-declared capability strings stored on the passport (not audited by Lithtrix).
    - `self_reported_notice` string, required: Mandatory disclaimer distinguishing self_reported strings from lithtrix:verified URIs.
  - `trust_levels` string[]: Platform-derived trust labels (non-exclusive): ``floor``, ``ephemeral``, ``staked``, ``sponsored``, etc. Never operator-writable (D88).
  - `stake` object, nullable: Active/unstaking stake summary when present (iter 88).
  - `reputation` object, nullable: Platform-derived reputation summary when passport present (iter 89).
  - `free_period` object, nullable: Rolling-30 free-floor summary per action (memory_write, search, browse) for trial tiers; null for paid starter/pro.
  - `skill_vouches` object, nullable: When ``passport_present``, per-skill vouch counts for this agent plus up to five ``voucher_ids`` per skill (own agent only — public passport shows counts only).

## Other responses

- `422`: Validation Error

---

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