---
title: "Get provider account invoice for a month"
method: GET
path: "/v1/providers/{provider_id}/account/invoices/{month}"
tags: ["account"]
---

# Get provider account invoice for a month

`GET /v1/providers/{provider_id}/account/invoices/{month}`

## Request

- Base URL: `https://mgmt.storage.dev`
- URL: `https://mgmt.storage.dev/v1/providers/{provider_id}/account/invoices/{month}`
- Auth: API key in header `X-Tigris-Signature` and API key in header `X-Tigris-Nonce` and API key in header `X-Tigris-Time`

Returns the provider's consolidated invoice for the specified month. This invoice
aggregates charges across all member organizations under the provider.

## Path parameters

- `provider_id` string, required
- `month` string, required

## Response `200`

OK

- GetInvoiceResponse
  - `data` Invoice
    - `org_id` string, required: Organization ID
    - `plan_name` string, required: Name of the plan
    - `charges` InvoiceCharge[], required: List of charges in the invoice
      - `id` string, required: Unique identifier for the charge
      - `name` string, required: User friendly name of the charge
      - `quantity` number, double, required: Number of units consumed
      - `unit` string, required: Consumption unit
      - `total` number, double, required: Total cost for the charge
      - `tiers` ChargeTier[], required
        - `name` string, required
        - `quantity` number, double, required: Number of units consumed
        - `starting_after` number, double, required: Starting point when this tier is applicable
        - `price` number, double, required: Rate per unit
        - `subtotal` number, double, required: Total cost for the tier
      - `charged_quantity` number, double, required: Actual number of units charged for
    - `subtotal` number, double, required: Amount before any credits/discounts/minimum commitments
    - `total` number, double, required: Total payable amount
    - `created_at` string, date-time, required: RFC3339 timestamp when this invoice was generated
    - `last_modified` string, date-time, required: RFC3339 timestamp when this invoice was last modified
    - `starting_on` string, date-time, required: RFC3339 starting time for usage period during which items were added to this invoice
    - `ending_before` string, date-time, required: RFC3339 ending time for usage period during which items were added to this invoice
    - `status` 'DRAFT' | 'FINALIZED' | 'PAID' | 'PAST_DUE', required: * `DRAFT` - Invoice can be modified as the billing period progresses * `FINALIZED` - Invoice is locked and can't be modified * `PAID` - Payment has been collected * `PAST_DUE` - Payment is overdue
    - `memo` string: Human-readable description explaining the billing context for this invoice
    - `minimum_commit` number, double: Volume commitment amount applied to the invoice
    - `credits` number, double: Credits applied to the invoice

## Other responses

- `default`: Unexpected error

---

[API](https://skmtc.dev/tigrisdata/apis/tigris-partner-integrations-api-reference.md) - [All operations](https://skmtc.dev/tigrisdata/apis/tigris-partner-integrations-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/tigrisdata/apis/tigris-partner-integrations-api-reference/revisions/b69856eb4c2c?raw)