---
title: "Gets the overview for the active billing period."
method: GET
path: "/billing-period/active"
tags: ["Billing"]
---

# Gets the overview for the active billing period.

`GET /billing-period/active`

## Query parameters

- `organizationId` string

## Response `200`

OK

- GetActiveBillingPeriodOverviewEndpointOutput
  - `id` string, required — The billing period ID.
  - `organizationId` string, required — The organization the billing period belongs to.
  - `startDate` string, date-time, required — The start date of the billing period.
  - `endDate` string, date-time, required — The end date of the billing period.
  - `status` 'Open' | 'Invoiced' | 'Void' | 'Reconciling' | 'PendingReview' | 'Closed', required
  - `totalGrossCost` number, double, required — The total gross cost before discounts.
  - `totalDiscount` number, double, required — The total discount amount.
  - `totalNetCost` number, double, required — The total net cost after discounts.
  - `totalResponseCount` integer, required — The total number of billable responses.
  - `lineItems` ILineItem[], required — The line items (running cost, platform fees, refunds, volume discounts).
    - union
      - object
        - `_t` 'MinimumSpendCommitment', required
        - `id` string, nullable
        - `name` string, required
        - `amount` number, double, required
        - `comment` string, nullable
      - object
        - `_t` 'Other', required
        - `id` string, required
        - `name` string, required
        - `amount` number, double, required
        - `comment` string, nullable
        - `quantity` integer, required
        - `unitPrice` number, double, required
      - object
        - `_t` 'PlatformFee', required
        - `id` string, required
        - `name` string, required
        - `amount` number, double, required
        - `comment` string, nullable
      - object
        - `_t` 'Refund', required
        - `id` string, required
        - `name` string, required
        - `amount` number, double, required
        - `comment` string, nullable
        - `quantity` integer, required
        - `unitPrice` number, double, required
      - object
        - `_t` 'RunningCost', required
        - `amount` number, double, required
      - object
        - `_t` 'VolumeDiscount', required
        - `amount` number, double, required
        - `effectiveDiscountRatio` number, double, required

## Other responses

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

## Changes

- **2026-08-19** `fdb89a6eb2fb` — 2 warning
  - added the new `Closed` enum value to the `status/allOf[#/components/schemas/BillingPeriodStatus]/` response property for the response status `200`
  - added the new `PendingReview` enum value to the `status/allOf[#/components/schemas/BillingPeriodStatus]/` response property for the response status `200`
- **2026-08-13** `d779de93a5ee` — 5 info
  - added the required property `lineItems/allOf[subschema #1]/items/oneOf[#/components/schemas/ILineItemOtherCharge]/quantity` to the response with the `200` status
  - added the required property `lineItems/allOf[subschema #1]/items/oneOf[#/components/schemas/ILineItemOtherCharge]/unitPrice` to the response with the `200` status
  - added the required property `lineItems/allOf[subschema #1]/items/oneOf[#/components/schemas/ILineItemRefund]/quantity` to the response with the `200` status
  - added the required property `lineItems/allOf[subschema #1]/items/oneOf[#/components/schemas/ILineItemRefund]/unitPrice` to the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/rapidata/apis/rapidata-api/changes/billing-period/active/get.md)

---

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