> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jointransfer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Retrieve the current agent

> Read the agent, limits, and wallet relationships for this key.

```http theme={"theme":{"light":"github-light","dark":"vesper"}}
GET /api/v1/agents/me
```

```bash theme={"theme":{"light":"github-light","dark":"vesper"}}
curl "$TRANSFER_BASE_URL/api/v1/agents/me" \
  -H "Authorization: Bearer $TRANSFER_AGENT_KEY"
```

## Response

Illustrative `200` response; IDs and amounts vary.

```json theme={"theme":{"light":"github-light","dark":"vesper"}}
{
  "data": {
    "type": "agent",
    "id": "907ad137-f690-4190-bc48-96a02c61a9d2",
    "attributes": {
      "name": "Research assistant",
      "mode": "simulation",
      "spending": {
        "monthlyLimit": 8000,
        "remainingMonthlyLimit": 8000,
        "perPurchaseLimit": 2000,
        "availableToSpend": 8000,
        "currency": "EUR",
        "fundsReserved": false
      },
      "cardStatus": "active"
    },
    "relationships": {
      "defaultWallet": {
        "data": { "type": "wallet", "id": "12574b54-ec5d-4af6-bc0f-f28d6242410c" }
      },
      "card": {
        "data": { "type": "card", "id": "1cf7b151-0f6c-4f34-9a6f-c60d61657ac5" }
      }
    }
  }
}
```

Amounts are integer EUR cents. `availableToSpend` is capped by the wallet balance and is zero when frozen. `cardStatus` is `active` or `frozen`. `fundsReserved: false` means allowances do not set aside wallet funds. The relationships identify resources; there is currently no REST card retrieval endpoint.

See [Spending controls](/concepts/spending-controls) and [Errors](/api-reference/errors).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.