---
title: "Organization Usage"
method: GET
path: "/api/v1/organizations/{organization_id}/usage"
tags: ["organization"]
---

# Organization Usage

`GET /api/v1/organizations/{organization_id}/usage`

## Request

- Base URL: `https://ndi-api.nace.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://ndi-api.nace.ai/api/v1/organizations/{organization_id}/usage`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/nace/apis/ndi-service/docs/api/v1/organizations/:organization_id/usage/get.ts> (a function with typed inputs; its response is checked against the schema)

The organization's resource allowance and finalized consumption.

The same numbers ``GET /api/v1/usage`` reports to an API-key caller, read here by
a human who need not hold a key.

## Path parameters

- `organization_id` string, uuid, required: Organization from POST /console/session.

## Response `200`

Successful Response

- NdiServiceAppSchemasPublicUsageResponse: Response for ``GET /usage`` (and ``GET /console/usage``). Resource consumption is summed after finalization, including free failed or cancelled work and excluding reuse waivers. Work in flight is not counted: this is the same view the legacy 402 gate sees. It is not a customer bill; ``/v1/usage`` reports final billable ``credits_total`` separately.
  - `included_credits` integer, nullable: Lifetime credit allowance; null means unlimited.
  - `credits_used` integer, required: Finalized credit-equivalent resource consumption, including unbilled failures and cancellations.
  - `credits_remaining` integer, nullable: Allowance minus usage, floored at 0; null when the allowance is unlimited.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: The account is disabled, or the caller's role does not permit this.
- `404`: No console account yet, or no membership in this organization.
- `409`: Conflict
- `413`: Request Entity Too Large
- `422`: Unprocessable Entity
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/nace/apis/ndi-service.md) - [All operations](https://skmtc.dev/nace/apis/ndi-service/llms.txt) - [OpenAPI document](https://skmtc.dev/nace/apis/ndi-service/revisions/d9d1f8ec2207?raw)