---
title: "Get reporting periods + customer display name"
method: GET
path: "/v1/billing/periods"
tags: ["Billing"]
---

# Get reporting periods + customer display name

`GET /v1/billing/periods`

## Request

- Base URL: `https://docs.grepr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.grepr.ai/v1/billing/periods`
- Auth: OpenID Connect (`https://grepr-prod.us.auth0.com/.well-known/openid-configuration`)

Returns the customer display name plus reporting periods available for the authenticated user's organization. Returns 404 when no billing record exists for the customer or no eligible subscription has any closed orders.

## Response `200`

Customer name + period list.

- BillingPeriodsResponse: Static customer header data for the billing page: display name + selectable reporting periods.
  - `customerName` string, required: Customer display name (e.g. "ACME, Inc.").
  - `periods` PeriodEntry[], required: Reporting periods available for this customer, newest first.
    - `current` boolean: True if this entry's period contains today.
    - `endDate` string, date, required: Inclusive period end date — the last day in the period.
    - `id` string, required: Canonical period identifier used in the URL — "YYYY-MM-DD" (the period's start date) for both monthly and annual plans.
    - `startDate` string, date, required: Inclusive period start date.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `500`: Internal Server Error

---

[API](https://skmtc.dev/grepr/apis/grepr-api.md) - [All operations](https://skmtc.dev/grepr/apis/grepr-api/llms.txt) - [OpenAPI document](https://skmtc.dev/grepr/apis/grepr-api/revisions/2a5ce03a0bf0?raw)