---
title: "List debt-shift proposals"
method: GET
path: "/debt-shifts/proposals"
tags: ["debt shifts"]
---

# List debt-shift proposals

`GET /debt-shifts/proposals`

## Request

- Base URL: `http://localhost:3001`
- URL: `http://localhost:3001/debt-shifts/proposals`
- Auth: HTTP bearer

Get pending debt-shift proposals where the authenticated user is the debtor (incoming) or the proposer (outgoing)

## Response `200`

Proposals retrieved successfully

- object
  - `data` DebtShiftProposalListResponseDto
    - `incoming` DebtShiftProposalResponseDto[], required: Pending proposals where you are the debtor and can accept or decline
      - `id` string, required: Proposal ID
      - `proposerId` string, required: User who proposed the shift
      - `proposerDisplayName` string, required: Proposer's display name
      - `debtorId` string, required: User who would take over the debt
      - `debtorDisplayName` string, required: Debtor's display name
      - `creditorId` string, required: User whose claim moves to the debtor
      - `creditorDisplayName` string, required: Creditor's display name
      - `currency` string, required: Currency code
      - `amount` number, required: Proposed amount
      - `targetGroupNames` string[], required: Group(s) holding the proposer's debt, where the debtor picks up the new debt
      - `status` 'pending' | 'accepted' | 'declined' | 'cancelled' | 'expired', required: Proposal status
      - `createdAt` string, date-time: When the proposal was created
    - `outgoing` DebtShiftProposalResponseDto[], required: Pending proposals you made and can cancel
      - `id` string, required: Proposal ID
      - `proposerId` string, required: User who proposed the shift
      - `proposerDisplayName` string, required: Proposer's display name
      - `debtorId` string, required: User who would take over the debt
      - `debtorDisplayName` string, required: Debtor's display name
      - `creditorId` string, required: User whose claim moves to the debtor
      - `creditorDisplayName` string, required: Creditor's display name
      - `currency` string, required: Currency code
      - `amount` number, required: Proposed amount
      - `targetGroupNames` string[], required: Group(s) holding the proposer's debt, where the debtor picks up the new debt
      - `status` 'pending' | 'accepted' | 'declined' | 'cancelled' | 'expired', required: Proposal status
      - `createdAt` string, date-time: When the proposal was created
  - `success` boolean
  - `message` string

## Other responses

- `400`: Bad Request - Invalid input or validation failed
- `401`: Unauthorized - Authentication required or invalid token
- `403`: Forbidden - Insufficient permissions to access this resource
- `404`: Not Found - The requested resource does not exist
- `500`: Internal Server Error - An unexpected error occurred

---

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