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

# getSparkInvoices

> Query the status of Spark invoices.

Queries the status of Spark invoices.

## Method Signature

```typescript theme={null}
async getSparkInvoices(params: QuerySparkInvoicesParams): Promise<{
  invoiceStatuses: InvoiceResponse[];
  offset: number;
}>

interface QuerySparkInvoicesParams {
  invoices: string[];
  limit?: number;   // default: 100
  offset?: number;  // default: 0
}
```

## Parameters

<ResponseField name="invoices" type="string[]" required>
  Array of Spark invoice strings to query. Must be non-empty.
</ResponseField>

<ResponseField name="limit" type="number">
  Maximum number of results to return (default: `100`).
</ResponseField>

<ResponseField name="offset" type="number">
  Offset for pagination (default: `0`).
</ResponseField>

## Returns

<ResponseField name="invoiceStatuses" type="InvoiceResponse[]" required>
  Array of invoice status objects.
</ResponseField>

<ResponseField name="offset" type="number" required>
  The offset used for this request.
</ResponseField>

## Example

```typescript theme={null}
const { invoiceStatuses } = await client.getSparkInvoices({
  invoices: ["spark1..."],
});

for (const invoice of invoiceStatuses) {
  console.log(invoice);
}
```