Get Ledger Accounts

get/v1/ledger-accounts/{ledger_account_id}

Fetches a single ledger account by its public id within the active workspace. Read only, no side effects. Returns 404 when the id is unknown or falls outside the caller's workspace scope.

Requires a bearer token: Authorization: Bearer <token>.

Path parameters

Name	Type	Required	Description
ledger_account_id	string <uuid>	Yes	Public UUID of the ledger account.e.g. b8c9d0e1-0000-4000-8000-0000000000a8

Query parameters

Name	Type	Required	Description
workspaceId	string <uuid>	No	Explicit workspace scope. The authenticated user must hold an active membership in this workspace. Defaults to the session workspace when omitted.e.g. a1b2c3d4-0000-4000-8000-000000000001

Request

cURL

curl -X GET https://api.wellapp.ai/v1/ledger-accounts/{ledger_account_id} \
  -H "Authorization: Bearer $WELL_API_TOKEN"

Responses

200 — The requested ledger account.

{
  "data": {
    "type": "ledger_account",
    "id": "b8c9d0e1-0000-4000-8000-0000000000a8",
    "attributes": {
      "ledger_account_id": "b8c9d0e1-0000-4000-8000-0000000000a8",
      "account_number": "627800",
      "name": "Software subscriptions",
      "description": "SaaS and cloud tooling",
      "account_type": "expense",
      "account_class": 6,
      "is_active": true,
      "is_auxiliary": false,
      "created_at": "2026-01-12T18:06:00Z",
      "updated_at": "2026-01-12T18:06:00Z",
      "deleted_at": null
    },
    "relationships": {
      "parent_account": {
        "data": {
          "type": "ledger_account",
          "id": "00000000-0000-4000-8000-000000000001"
        }
      },
      "child_accounts": {
        "data": [
          {
            "type": "ledger_account",
            "id": "00000000-0000-4000-8000-000000000001"
          }
        ]
      }
    }
  }
}

401 — Unauthorized

{
  "code": "UNAUTHORIZED",
  "status": 401,
  "title": "Unauthorized",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}

404 — Not found

{
  "code": "NOT_FOUND",
  "status": 404,
  "title": "Not Found",
  "message": "See title.",
  "meta": {
    "trace_id": "a1b2c3",
    "log_id": "a1b2c3"
  }
}