---
title: "Read the agent-owned account"
method: GET
path: "/credits/agent/account"
tags: ["Agent-native onboarding"]
---

# Read the agent-owned account

`GET /credits/agent/account`

## Request

- Base URL: `https://api.paywithlocus.com/api`
- URL: `https://api.paywithlocus.com/api/credits/agent/account`
- Auth: HTTP bearer

Returns only the authenticated self-registered account, its usable pooled balance, expiry, links, and next action. Tenant-managed agent connections are rejected.

## Response `200`

Agent-owned account state

- AgentOwnedAccountEnvelope
  - `success` unknown, required
  - `account` AgentOwnedAccount, required
    - `id` string, uuid, required
    - `name` string, required
    - `status` string, required
    - `onboardingState` 'funding_required' | 'ready', required
    - `balance` AgentOwnedBalance, required
      - `usd` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
      - `credits` string, required: Non-negative exact decimal string with at most six fractional digits. Endpoint-specific positivity and amount limits still apply.
      - `creditsPerDollar` string, required
    - `connection` object, required
      - `id` string, uuid, required
      - `keyPrefix` string, required
      - `expiresAt` string, date-time, required
      - `credential` string: Returned on registration replay and rotation. Store immediately.
    - `identity` object, required
      - `provider` 'agentid', required
      - `email` string, email, required
    - `mcp` object, required
    - `links` object, required
    - `nextAction` object, required
    - `created` boolean
    - `credentialRenewed` boolean
    - `credentialRecovered` boolean
    - `activated` unknown, required

## Other responses

- `403`: The credential belongs to a tenant-managed connection

---

[API](https://skmtc.dev/paywithlocus/apis/locus-pro-api.md) - [All operations](https://skmtc.dev/paywithlocus/apis/locus-pro-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paywithlocus/apis/locus-pro-api/revisions/aab8fa5d6cef?raw)