> ## Documentation Index
> Fetch the complete documentation index at: https://widgetic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# widgetic api invoices

> 1 command for the Invoices operations of the REST API, generated from its OpenAPI description.

`widgetic api invoices <command>` runs the Invoices operations of the REST API. It has 1 command. Every command also takes [the flags every command takes](https://widgetic.com/docs/cli/commands/index.md).

## `widgetic api invoices get-invoices-by-partner-id`

List a partner's invoices

* Request: `GET /invoices/partner/{partnerId}`
* Operation: `getInvoicesByPartnerId` (`widgetic api call getInvoicesByPartnerId` runs it by that name)
* Needs a partner API key (wgt\_prt\_…).

| Flag | Takes | Required | What it does |
| - | - | - | - |
| `--partner-id <uuid>` | uuid | yes | The partner whose invoices to list |
| `--status <text>` | one of `draft`, `open`, `pending`, `paid`, `failed`, `void`, `uncollectible`, `refunded`, `canceled` | | Only invoices with this status |
| `--limit <int>` | integer | | Maximum number of invoices to return (default: 50) |
| `--offset <int>` | integer | | Number of invoices to skip (default: 0) |

The whole description and the schemas: `widgetic schema api invoices get-invoices-by-partner-id`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.