---
title: "Retrieves the collection of Purchase resources."
method: GET
path: "/purchases"
tags: ["Purchase"]
---

# Retrieves the collection of Purchase resources.

`GET /purchases`

Retrieves the collection of Purchase resources.

## Query parameters

- `page` integer
- `itemsPerPage` integer

## Response `200`

Purchase collection

- Purchase[]
  - `id` string — Unique identifier for this purchase note that no particular pattern in this field is guaranteed, only that this field is unique e.g: "stripe-5050"
  - `integration` string — The key of the integration source e.g. "quickbooks", or "xero"
  - `paymentType` string, nullable — Payment type e.g: "CreditCard"
  - `accountId` string — ID of account associated with purchase e.g: "1057"
  - `currency` string, nullable — Currency code e.g. USD
  - `txnDate` string, nullable — Transaction date e.g. "2019-08-25"
  - `totalAmount` integer — Total amount purchased in cents e.g. 450000
  - `created` string, date-time, nullable — Date entry was created e.g. "2019-08-25T02:17:40.080Z"
  - `modified` string, date-time, nullable — Date purchase was last modified e.g. "2019-08-26T02:17:40.080Z"
  - `srcId` string — The unique identifier of the source 3rd party integration e.g. "GH2JK-67283H-YW82KHX-2883KK-KS78S"
  - `customerId` string, nullable — Id of the customer who made the purchase e.g. "C056"
  - `name` string, nullable — Name of the purchase e.g. "purchase name"
  - `status` string, nullable — Status of the product e.g. "shipped"
  - `quantity` integer, nullable — Quantity purchased e.g. 10
  - `amountPerUnit` string, nullable — Amount per unit e.g. "450"
  - `txnId` string, nullable — Transaction Id e.g. "4560"
  - `accountName` string, nullable — Name of the account associated with the purchase e.g. "Cool Cars"
  - `invoiceId` string, nullable — ID of the invoice associated with the purchase e.g. "9870028192"
  - `contactId` string, nullable — Id of the contact which is usually a payee e.g. "23"
  - `contactName` string, nullable — Name of the contact which is usually a payee e.g. "Cool Cars"
  - `contactType` string, nullable — Type of the contact which can be customer, vendor, or employee
  - `paymentMethodId` string, nullable — Reference to the related Payment Method object

---

[API](https://skmtc.net/bossinsights/apis/boss-insights.md) · [All operations](https://skmtc.net/bossinsights/apis/boss-insights/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bossinsights/boss-insights/versions/d08a107895ad/schema)