---
title: "Get Customer Invoices"
method: GET
path: "/api/v1/stripe-invoices/customers/invoices"
tags: ["User APIs", "stripe-invoices", "stripe-invoices"]
---

# Get Customer Invoices

`GET /api/v1/stripe-invoices/customers/invoices`

## Request

- Base URL: `https://carbonarc.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://carbonarc.ai/api/v1/stripe-invoices/customers/invoices`
- Auth: OAuth 2 (authorization code, authorization URL `authorize`, token URL `token`)

## Response `200`

Successful Response

- StripeCustomerInvoiceListResponse
  - `invoices` StripeCustomerInvoice[], required
    - `id` string, required
    - `number` string, nullable
    - `title` string, nullable
    - `amount_due` integer, nullable
    - `currency` string, nullable
    - `status` string, nullable
    - `created` integer, nullable
    - `due_date` integer, nullable
    - `period_start` integer, nullable
    - `period_end` integer, nullable
    - `hosted_invoice_url` string, nullable
    - `customer_name` string, nullable
    - `is_block` boolean
    - `dataset_name` string, nullable
  - `has_more` boolean, required
  - `first_id` string, nullable
  - `last_id` string, nullable

## Changes

- **2026-08-21** `a8ca30023371`: 2 info
  - added the optional property `invoices/items/dataset_name` to the response with the `200` status
  - added the optional property `invoices/items/is_block` to the response with the `200` status

[Operation history](https://skmtc.dev/carbonarc/apis/carbon-arc-client-admin-api/changes/api/v1/stripe-invoices/customers/invoices/get.md)

---

[API](https://skmtc.dev/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.dev/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc.dev/carbonarc/apis/carbon-arc-client-admin-api/revisions/56e2edae9dfe?raw)