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

> ## Agent Instructions
> Automate.ax automations are TypeScript programs.
> Use Bun for installation and command examples.
> Use Automate.ax for the product name and automate.ax for the package, CLI, and domain.
> Treat documented public APIs as current; do not invent transitional or deprecated names.

# List purchases

> Lists purchases recorded in the account.

`kit.listPurchases` lists purchases recorded in the account.

```ts automations/list-purchases.automation.ts theme={null}
import { automation, markSignificant } from "automate.ax"
import { kit } from "automate.ax/kit"

export default automation("List purchases", () => {
  markSignificant(kit.listPurchases({}))
})
```

## Input

Pass these fields:

| Field               | Type              | Required | Description                |
| ------------------- | ----------------- | -------- | -------------------------- |
| `after`             | `string \| null`  | No       | —                          |
| `before`            | `string \| null`  | No       | —                          |
| `includeTotalCount` | `boolean`         | No       | —                          |
| `perPage`           | `integer \| null` | No       | Minimum: 1. Maximum: 1000. |

## Output

Returns an object with these fields:

| Field        | Type       | Required | Description |
| ------------ | ---------- | -------- | ----------- |
| `purchases`  | `object[]` | Yes      | —           |
| `pagination` | `object`   | Yes      | —           |

> This action requires a Kit OAuth connection. Kit does not allow V4 API keys for this endpoint.

Kit list and reporting endpoints can lag recent writes. Cursor-based list actions accept `after` or `before`; `perPage` defaults to Kit's provider default and cannot exceed 1,000.

Kit rate limits OAuth connections to 600 requests per 60 seconds and V4 API keys to 120 requests per 60 seconds. Automate.ax honors provider retry timing for rate-limit and temporary bulk-capacity responses.