# List proposals

> GET /proposals

Source: https://docs.trykintsugi.com/reference/2026-07-21/list-proposals

API version: Tenanted API release 2026-07-21

GET /proposals

List proposals

List the proposals Kintsugi sent, newest first by `createdAt`, keyset-paginated. Each proposal shows when it was sent and decided and, once accepted, what happened next. Covers every organization your credential can access; pass an `Organization-Id`, `Connection-Id` or `Entity-Id` selector to narrow to one. Pass `limit` and the opaque `cursor` from a prior response's `nextCursor` or `previousCursor` to page. A cursor is only valid for the filter and organization scope it was issued under.

Category: Proposals

Query parameters:
status (PublicProposalStatusEnum) - Only return proposals in this status.
  allowed values: AWAITING_CUSTOMER, APPROVED, DECLINED
limit (integer) - Maximum number of items to return.
cursor (string) - Opaque cursor from a prior response's nextCursor or previousCursor. Omit for the first page.

Response fields:
items (Proposal[], required) - The proposals on this page.
  id (string, required) - The proposal's id.
  organizationId (string, required) - The organization the proposal was sent to.
  subType (PublicProposalSubTypeEnum, required) - What the proposal asks the customer to approve.
    allowed values: BALANCE_DUE, BACKFILING
  status (PublicProposalStatusEnum, required) - Where the proposal stands with the customer.
    allowed values: AWAITING_CUSTOMER, APPROVED, DECLINED
  detail (string, required) - Why Kintsugi sent the proposal.
  declineReason (string, required) - The customer's reason for declining. `null` unless the status is `DECLINED`.
  currency (PublicCurrencyEnum, required) - ISO-4217 currency of every amount on this proposal.
    allowed values: AED, AFN, ALL, AMD, ANG, AOA, ARS, AUD, AWG, AZN, BAM, BBD (and 150 more, see the reference page)
  items (ProposalItem[], required) - The states and periods the proposal covers, oldest period first.
    id (string, required) - The item's id.
    stateCode (string, required) - The two-letter state the item is for.
    periodYear (integer, required) - The filing period's year. `null` when the item is for a state and not one period.
    periodMonth (integer, required) - The filing period's month, 1 to 12. `null` when the item is for a state and not one period.
[truncated, see the reference page]

---

Index of every page: https://docs.trykintsugi.com/llms.txt