---
title: "Estado, mandate, metricas e linhagem de um agente"
method: GET
path: "/mesh/agents/{agent_id}"
tags: ["Mesh · Identity"]
---

# Estado, mandate, metricas e linhagem de um agente

`GET /mesh/agents/{agent_id}`

## Request

- Base URL: `https://api.luniumpay.com`
- URL: `https://api.luniumpay.com/mesh/agents/{agent_id}`
- Auth: none required

## Path parameters

- `agent_id` string, required

## Response `200`

O agente.

- AgentIdentity: Identidade PERMANENTE do agente. Credencial e substituivel; linhagem, volume, recompensa, mandate e reputacao pertencem ao agent_id.
  - `agent_id` string
  - `name` string
  - `description` string, nullable
  - `contact` string, nullable
  - `status` 'registered' | 'sandbox_active' | 'validated' | 'production_active' | 'suspended': Producao e ativada por POLITICA, sem humano no circuito. Nao existe estado de espera por aprovacao: o controle de risco esta na regua por PAGADOR (cash-in), no teto por operacao, no teto diario de quem recebe o PIX (venda) e no mandate da propria chave — nao existe teto diario por chave de API (desde 10/09/2026), nem fila de aprovacao.
  - `environment` 'sandbox' | 'production'
  - `capabilities` string[]
  - `settlement_address` string, nullable
  - `referred_by` string, nullable: Imutavel apos o registro (gatilho no banco).
  - `created_at` string, date-time

## Other responses

- `404`: Nao existe.

---

[API](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil.md) · [All operations](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/llms.txt) · [OpenAPI document](https://skmtc.dev/luniumpay/apis/lunium-crypto-pix-settlement-brazil/revisions/0b5a340fa9dd?raw)