---
title: "Get Invoice Payment Promises"
method: GET
path: "/v2/invoices/{invoice_id}/payment-promises"
tags: ["invoices"]
---

# Get Invoice Payment Promises

`GET /v2/invoices/{invoice_id}/payment-promises`

## Request

- Base URL: `https://api.stuut.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.stuut.ai/v2/invoices/{invoice_id}/payment-promises`
- Auth: HTTP bearer

List Payment Promises

Return the payment-promise history for an invoice, newest first.

## Path parameters

- `invoice_id` string, required

## Response `200`

Successful Response

- PaymentPromiseSchema[]
  - `id` string, required
  - `created_at` string, date-time, required
  - `promised_to_pay_date` string, date, nullable, required
  - `source` 'email' | 'call' | 'sms' | 'user' | 'integration_sync', required
  - `partner_id` string, nullable, required
  - `invoice_id` string, nullable, required
  - `email_id` string, nullable, required
  - `call_id` string, nullable, required
  - `sms_id` string, nullable, required
  - `created_by_user_id` string, nullable, required
  - `extracted_invoice_number` string, nullable, required
  - `payment_type` 'ach' | 'wire' | 'check' | 'other', required
  - `sent_date` string, date, nullable, required
  - `amount` string, decimal, nullable, required
  - `currency` string, nullable, required
  - `is_calculated` boolean, required
  - `is_promised_date_updated` boolean, required
  - `agent_confidence_score` integer, nullable, required
  - `agent_confidence_reason` string, nullable, required
  - `agent_uncertainties` string[], required
  - `agent_error_code` string, nullable, required

## Other responses

- `422`: Validation Error

---

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