---
title: "GET /v1/workspaces/{workspaceId}/billing/invoices"
method: GET
path: "/v1/workspaces/{workspaceId}/billing/invoices"
tags: ["Billing"]
---

# GET /v1/workspaces/{workspaceId}/billing/invoices

`GET /v1/workspaces/{workspaceId}/billing/invoices`

## Request

- Base URL: `https://api.atlas-compiler.com`
- URL: `https://api.atlas-compiler.com/v1/workspaces/{workspaceId}/billing/invoices`
- Auth: HTTP bearer

## Path parameters

- `workspaceId` string, required

## Response `200`

Success

- object
  - `invoices` object[], required
    - `amountPaidCents` integer, required: Amount paid in USD cents (minor currency units)
    - `createdAt` string, date-time, required
    - `currency` string, required: Three-letter ISO currency code
    - `hostedInvoiceUrl` string, uri, nullable, required: Direct downloadable invoice or receipt URL
    - `id` string, required: Internal invoice identifier
    - `paidAt` string, date-time, nullable, required
    - `periodEnd` string, date-time, nullable, required
    - `periodStart` string, date-time, nullable, required
    - `providerInvoiceId` string, required: Payment provider invoice or charge identifier
    - `status` 'paid' | 'succeeded' | 'open' | 'failed' | 'refunded' | 'void' | 'uncollectible', required: Canonical invoice payment status

## Other responses

- `400`: RFC 9457 problem.
- `401`: RFC 9457 problem.
- `403`: RFC 9457 problem.
- `404`: RFC 9457 problem.
- `409`: RFC 9457 problem.
- `500`: RFC 9457 problem.
- `503`: RFC 9457 problem.

---

[API](https://skmtc.dev/atlas-compiler/apis/atlas-backend-api.md) · [All operations](https://skmtc.dev/atlas-compiler/apis/atlas-backend-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atlas-compiler/apis/atlas-backend-api/revisions/a43b60619cdf?raw)