---
title: "GET /internal/billing-ops/accounts/{accountId}"
method: GET
path: "/internal/billing-ops/accounts/{accountId}"
tags: ["BillingOps"]
---

# GET /internal/billing-ops/accounts/{accountId}

`GET /internal/billing-ops/accounts/{accountId}`

## Request

- Base URL: `https://api.greentally.ai/v1`
- URL: `https://api.greentally.ai/v1/internal/billing-ops/accounts/{accountId}`
- Auth: HTTP bearer

## Path parameters

- `accountId` string, required

## Response `200`

Internal billing account summary

- BillingSummaryResponse
  - `data` BillingSummary, required
    - `accountId` string, required
    - `accountName` string
    - `accountSlug` string
    - `balance` CreditBalance, required
      - `accountId` string, required
      - `credits` integer, required
      - `frozen` boolean, required
      - `initialized` boolean, required
      - `reason` string
    - `billedTo` object, nullable: Set while a partner's shared pool pays for this account's AI usage (partner layer): balance is then the pool's, read-only, and transactions are only the pool's debits made for this account. Left out otherwise.
      - `partnerName` string, required
    - `credits` PlanCredits
      - `allowance` integer, required
      - `allowanceMonthly` integer, required
      - `allowanceResetsAt` string, date-time, nullable, required
      - `topUp` integer, required
    - `plan` BillingPlan, required
      - `active` boolean, required
      - `code` string, required
      - `featureGates` object, required
      - `id` string, required
      - `includedMonthlyCredits` integer, required
      - `name` string, required
      - `overageEnabled` boolean, required
    - `transactions` CreditTransaction[]
      - `accountId` string, required
      - `amountCredits` integer, required
      - `balanceAfterCredits` integer, required
      - `createdAt` string, date-time, required
      - `createdBy` string, required
      - `expiresAt` string, date-time
      - `forAccountId` string: The client (its Clerk organization id) a partner pool debit paid for. Absent on an account's own transactions.
      - `id` string, required
      - `reason` string, required
      - `resourceLabel` string
      - `sourceId` string, required
      - `sourceType` string, required
      - `type` string, required
    - `usage` BillingUsage, required
      - `byFeature` BillingUsageGroup[], required
        - `credits` integer, required
        - `displayName` string
        - `key` string, required
        - `tokens` integer, required
      - `byOrg` BillingUsageGroup[], required
        - `credits` integer, required
        - `displayName` string
        - `key` string, required
        - `tokens` integer, required
      - `totalCredits` integer, required
      - `totalTokens` integer, required
  - `meta` object

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

## Changes

- **2026-10-07** `5c524454c847`: 1 info
  - added the optional property `data/credits` to the response with the `200` status
- **2026-10-06** `461a0ebc7731`: 2 info
  - added the optional property `data/billedTo` to the response with the `200` status
  - added the optional property `data/transactions/items/forAccountId` to the response with the `200` status

[Operation history](https://skmtc.dev/greentally/apis/esgai-api/changes/internal/billing-ops/accounts/:accountId/get.md)

---

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