---
title: "Get usage summaries (v3)"
method: GET
path: "/api/v1/billing/usage-summaries-v3/{id}"
tags: ["billing"]
---

# Get usage summaries (v3)

`GET /api/v1/billing/usage-summaries-v3/{id}`

## Request

- Base URL: `https://point11.ai`
- URL: `https://point11.ai/api/v1/billing/usage-summaries-v3/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://auth.point11.ai/oauth2/authorize`, token URL `https://auth.point11.ai/oauth2/token`)

Read the organization's usage this billing period: each offer's settled units, including fractional API dollars, allowance position, pending runs, and settled overage, and the overage no invoice has billed yet with the date the next invoice bills it and the unbilled amount that invoices it sooner. Every subscribed account bills usage past the plan on its invoice. The id is the organization id.

## Path parameters

- `id` string, required

## Headers

- `Point11-Organization` string, uuid

## Response `200`

Success.

- BillingUsageSummariesGetV3Response
  - `observedAt` string, date-time, required
  - `period` object, nullable, required
    - `start` string, date-time, required
    - `end` string, date-time, required
    - `prorated` boolean, required
  - `usage` object[], required
    - `identity` string, required
    - `productSlug` string, required
    - `dimensionKey` string, required
    - `unitPriceCents` integer, required
    - `included` integer, nullable, required
    - `used` number, required
    - `held` integer, required
    - `remaining` integer, required
    - `overageUnits` number, required
    - `overageUsd` string, required
    - `pending` integer, required
    - `share` number, required
    - `productName` string, nullable, required
    - `productId` string, nullable, required
    - `label` object, required
      - `singular` string, required
      - `plural` string, required
    - `placement` 'campaigns' | 'alpha' | 'other', required
    - `unit` 'count' | 'usd', required
    - `usedQuantity` string, required
    - `overageQuantity` string, required
  - `overageUsdSettledThisPeriod` string, required
  - `pendingRuns` integer, required
  - `billedThroughMarketplace` boolean, required
  - `unbilledUsage` object, nullable, required
    - `overageCents` integer, required
    - `invoicedOn` string, date-time, nullable, required
    - `invoicedEarlyAtCents` integer, nullable, required

## Other responses

- `400`: The input, query, or Idempotency-Key is invalid.
- `401`: The bearer is missing, expired, or not accepted.
- `403`: The credential lacks the operation's scope or role, or the operation needs a different door.
- `404`: The resource or organization does not exist for this caller.
- `405`: This path takes another HTTP method, named in `Allow`.
- `409`: The request conflicts with current state or with prior use of its Idempotency-Key.
- `413`: The request, or the answer it asks for, is too large; narrow it.
- `429`: The credential's rate budget is spent; retry after `Retry-After` seconds.
- `500`: An unexpected server failure; retry later. Only `request_id` identifies it.
- `503`: A dependency is temporarily unavailable; retry after `Retry-After` seconds.
- `default`: Another status a product answers for its own refusal (for example `415` for an unsupported attachment); branch on `code`.

---

[API](https://skmtc.dev/point11/apis/point11-api.md) · [All operations](https://skmtc.dev/point11/apis/point11-api/llms.txt) · [OpenAPI document](https://skmtc.dev/point11/apis/point11-api/revisions/36a84c7aca11?raw)