---
title: "Read current invoices for a billing record"
method: GET
path: "/broker/payments/{program_id}/invoices"
tags: ["Payments"]
---

# Read current invoices for a billing record

`GET /broker/payments/{program_id}/invoices`

## Request

- Base URL: `https://api.hedgespecialty.com/api/v1`
- URL: `https://api.hedgespecialty.com/api/v1/broker/payments/{program_id}/invoices`
- Auth: OAuth 2
  - Authorization code: `https://api.hedgespecialty.com/api/v1/oauth/authorize`
  - Client credentials
  - Token URL: `https://api.hedgespecialty.com/api/v1/oauth/token`

Reads provider invoice facts for a billing record belonging to your
brokerage. Use the program_id returned by GET /broker/payments.
Read scope is enough. This request does not create, repair or send
invoices, payment links or billing programs. Missing invoice facts
remain null; provider failures return an error rather than an empty
list. Advance invoices remain available through the billing link.

## Path parameters

- `program_id` string, uuid, required

## Response `200`

Current provider invoices; an empty list means none were returned

- object[]
  - `id` string, required
  - `status` string, nullable
  - `amount_cents` integer, nullable: Invoice amount in cents; zero is a known amount
  - `due_date` string, nullable
  - `paid_at` string, nullable
  - `invoice_url` string, nullable
  - `invoice_number` string, nullable

## Other responses

- `404`: Billing record not found in your brokerage
- `422`: Advance invoice requires the existing hosted billing link
- `502`: Provider invoice response could not be read
- `503`: Invoice details are unavailable or the provider read failed; retry later

## Changes

- **2026-11-05** `beefa9cdc11c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/changes/broker/payments/:program_id/invoices/get.md)

---

[API](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api.md) - [All operations](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hedgespecialty/apis/hedge-submission-api/revisions/beefa9cdc11c?raw)