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

# Retrieves the collection of BillPayment resources.

`GET /bill_payments`

Retrieves the collection of BillPayment resources.

## Query parameters

- `page` integer
- `itemsPerPage` integer

## Response `200`

BillPayment collection

- BillPayment[]
  - `id` string
  - `integration` string — The key of the integration source e.g. "quickbooks", or "xero"
  - `srcId` string — the unique identifier of the source 3rd party integration e.g. "460000000053219"
  - `billId` string — The source ID of the bill being paid
  - `vendorPaymentId` string, nullable — The Boss Insights identifier for the Vendor Payment that this Bill Payment belongs to (if it belongs to one) Note that no particular pattern in this field is guaranteed, only that this field is unique
  - `vendorId` string, nullable — Unique identifier for the vendor of the bill e.g. "460000000026049"
  - `vendorName` string, nullable — Name of the vendor of the bill e.g. "Bowman and Co"
  - `paymentMode` string, nullable — Mode of payment e.g. "Stripe"
  - `txnDate` string, date-time, nullable — Date the payment is made e.g. "2013-10-07"
  - `referenceNumber` string, nullable — Reference number for the payment recorded e.g. REF#912300
  - `amount` integer — Total amount of the payment in cents e.g. 12500
  - `currency` string, nullable — Currency code e.g. "USD"
  - `created` string, date-time, nullable — Creation time of the payment e.g. 2016-12-16T00:18:42-0500
  - `modified` string, date-time, nullable — Last modified time of the payment e.g. 2016-12-16T00:18:42-0500

---

[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/revisions/d08a107895ad/schema)