---
title: "List debtors"
method: GET
path: "/debtor"
---

# List debtors

`GET /debtor`

## Request

- Base URL: `https://collectwiseapi.com`
- URL: `https://collectwiseapi.com/debtor`
- Auth: API key in header `collectwise_key`

Returns all debtors from the system that the user has access to

## Query parameters

- `limit` integer

## Headers

- `x-cw-timestamp` string
- `x-cw-signature` string

## Response `200`

A list of debtors

- DebtorResponse[]
  - `debtorId` string, required: Unique identifier of the debtor
  - `debtorName` string, required: Full name of the debtor
  - `totalUnpaidDebt` number, float, required: Total amount of unpaid debt
  - `delinquencyDate` string, date, required: Date when the debt became delinquent
  - `phoneNumber` string: Contact phone number of the debtor
  - `email` string, email: Email address of the debtor
  - `callbackNumber` string: Callback phone number
  - `productOrService` string: Name of the product or service delivered to the debtor
  - `creditorName` string, required: Name of the creditor
  - `creditorEmail` string, email: Creditor email if provided
  - `lastUpdated` string, date-time, required: Timestamp of the last update to this record
  - `accountNumber` string: Account number associated with the debt
  - `address` string: Street address of the debtor
  - `city` string: City of the debtor
  - `state` string: State of the debtor
  - `zipCode` string: ZIP code of the debtor
  - `county` string: County of the debtor
  - `ssn` string: Social Security Number of the debtor
  - `lastPayDate` string, date: Date of the last payment made by the debtor
  - `chargeOffDate` string, date: Date when the debt was charged off, if applicable
  - `interestDue` number, float: Amount of interest due on the debt
  - `principalDue` number, float: Amount of principal due on the debt
  - `otherFees` number, float: Other fees associated with the debt
  - `amountPaid` number, float: Total amount paid by the debtor so far
  - `paymentLink` string, nullable: Payment link associated with the debtor
  - `customWorkflowID` string: Custom workflow identifier for the debtor
  - `enrollment` object: Present only when customWorkflowID is provided
    - `attempted` boolean
    - `success` boolean
    - `message` string
    - `workflowId` string
    - `agentName` string: Agent name passed in the request. This is echoed back; if not provided, the service falls back internally to merchantName/email, but only the raw agentName is returned here.
  - `customization` string: Custom instructions for AI collection workflow (e.g., tone, channel preferences, frequency). If not provided, the system will generate an optimal collection flow.

## Other responses

- `400`: Bad request
- `429`: Your organization's shared rate limit has been exceeded. Wait at least the number of seconds specified in Retry-After before retrying.

## Changes

- **2026-11-03** `95fad0d2f369`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/collectwise/apis/collectwise-api/changes/debtor/get.md)

---

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