---
title: "List all invoices"
method: GET
path: "/workspaces/{workspace_id}/subscription_v1/invoices"
tags: ["Subscription"]
---

# List all invoices

`GET /workspaces/{workspace_id}/subscription_v1/invoices`

## Request

- Base URL: `https://app.mammoth.io/api/v2`
- URL: `https://app.mammoth.io/api/v2/workspaces/{workspace_id}/subscription_v1/invoices`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-KEY` and API key in header `X-API-SECRET` and API key in header `X-WORKSPACE-ID`

List all invoices for the workspace subscription

## Path parameters

- `workspace_id` integer, required: Workspace refers to a collection of projects. Workspace ID is unique identifier for workspace.

## Query parameters

- `limit` integer: Max number of result to return
- `sort` string: Returns resource based on this parameter. Use the format '(field:asc)' for ascending and '(field:desc)' for descending order. Allowed values: date and updated_at

## Response `200`

List of invoices

- InvoicesSchema
  - `invoices` object[], required: Invoices of the subscription

## Other responses

- `400`: Bad Request
- `401`: Authorization error
- `403`: Request forbidden -- authorization will not help

---

[API](https://skmtc.dev/mammoth/apis/mammoth-analytics.md) · [All operations](https://skmtc.dev/mammoth/apis/mammoth-analytics/llms.txt) · [OpenAPI document](https://skmtc.dev/mammoth/apis/mammoth-analytics/revisions/9d8804f81a10?raw)