---
title: "Gets the current-period usage and applicable limit for a customer."
method: GET
path: "/billing/summary"
tags: ["Billing"]
---

# Gets the current-period usage and applicable limit for a customer.

`GET /billing/summary`

Defaults to the authenticated customer when no customerId is provided.

## Query parameters

- `organizationId` string

## Response `200`

OK

- GetBillingSummaryEndpointOutput
  - `mode` 'Usage' | 'Limited' | 'Prepaid', required
  - `currentPeriodUsage` number, double, required — The accumulated billable spend in the current billing period.
  - `effectiveLimit` number, double, nullable — The spending cap for the current period, or null when unlimited.
  - `availableAmount` number, double, nullable — The remaining prepaid balance, set only for prepaid customers.
  - `minimumSpendCommitment` number, double, required — Dollars the customer has committed to spend per billing period; 0 means no commitment.

## Other responses

- `400` — Bad Request
- `401` — Unauthenticated
- `403` — Forbidden

---

[API](https://skmtc.net/rapidata/apis/rapidata-api.md) · [All operations](https://skmtc.net/rapidata/apis/rapidata-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/rapidata/rapidata-api/revisions/e42ec51c7b88/schema)