# GET /v1/organizations/:orgId/credits (/docs/api/reference/organizations/credits/get-credits)



<Endpoint method="GET" path="/v1/organizations/{orgId}/credits" auth="Bearer" scope="org:admin" phase="1" />

To see how much funding one of your customers has left, read that customer's child wallet. You call this with your parent (`org:admin`) key. The shape is identical to your own [`GET /v1/credits`](/docs/api/reference/credits/get-credits) - same balances, same per-format estimates - but scoped to the child named in the path.

The wallet reports **two** numbers, and the difference matters:

* **`balance`** - the gross wallet: included credits remaining this period plus the prepaid balance.
* **`available`** - what the child can actually spend on new work *right now*: `balance` minus credits already **reserved** for in-flight generations. Generations reserve credits the moment a workflow starts and settle when it finishes, so `available` can be lower than `balance` while work is mid-flight.

Gate a "can this customer generate?" decision on &#x2A;*`available`**, not `balance` - reserving against the gross number double-spends credits already committed to running jobs.

<Parameters
  title="Path"
  rows="[
  { name: 'orgId', type: 'string (org_…)', required: true, description: 'The child organization whose wallet you want. Must be a direct child of your org - otherwise 404.' },
]"
/>

## Example [#example]

```bash
curl https://api.layers.com/v1/organizations/org_d4e5f6a7-8b9c-4d0e-9f2a-3b4c5d6e7f80/credits \
  -H "Authorization: Bearer $LAYERS_PARENT_KEY"
```

<Response status="200" description="OK">
  ```json
  {
    "organizationId": "org_d4e5f6a7-8b9c-4d0e-9f2a-3b4c5d6e7f80",
    "balance": 6000,
    "available": 5880,
    "includedRemaining": 600,
    "prepaidBalance": 5400,
    "reservedCredits": 120,
    "includedThisPeriod": 1000,
    "usedThisPeriod": 400,
    "currentPeriod": {
      "start": "2026-06-01T00:00:00.000Z",
      "end": "2026-07-01T00:00:00.000Z",
      "usedCredits": 400
    },
    "subscriptionTier": "pro",
    "billingStatus": "active",
    "estimatedCreditsPerFormat": {
      "slideshow_builder": 50,
      "slideshow_remix": 50,
      "video_remix": 120,
      "ugc_remix": 120,
      "auto": 120
    },
    "ingestCostsBilled": {
      "github": false,
      "website": false,
      "appstore": false
    }
  }
  ```
</Response>

### Field notes [#field-notes]

* `balance` = `includedRemaining + prepaidBalance` (gross). `available` = `balance - reservedCredits`, floored at 0.
* `reservedCredits` is credit committed to in-flight work. It exists so `balance - reservedCredits === available` reconciles client-side. When nothing is running, `reservedCredits` is 0 and `available === balance`.
* `prepaidBalance` here is the portion you've funded into the child via [allocate](/docs/api/reference/organizations/credits/allocate) (plus any direct top-ups), net of the child's spend. `includedRemaining` is the child's own subscription allotment, if any.
* `estimatedCreditsPerFormat` is a defensive upper bound for pre-flight UI prompts; the authoritative deduction happens server-side after generation.
* `ingestCostsBilled` flags whether ingest debits credits. All three are `false` today.

## Errors [#errors]

| Status | Code          | When                                                                                                               |
| ------ | ------------- | ------------------------------------------------------------------------------------------------------------------ |
| 404    | `NOT_FOUND`   | `:orgId` is not a direct child of your org (anti-enumeration - a stranger's org looks identical to a missing one). |
| 422    | `VALIDATION`  | Malformed `:orgId`.                                                                                                |
| 503    | `KILL_SWITCH` | Your key or org is suspended; or the child org is suspended/archived.                                              |

## See also [#see-also]

* [Allocate credits](/docs/api/reference/organizations/credits/allocate) - fund this child from your parent wallet.
* [Child credit events](/docs/api/reference/organizations/credits/list-events) - the child's per-event ledger.
* [GET /v1/credits](/docs/api/reference/credits/get-credits) - your own wallet, same shape.