---
title: "List cases for referral partner clients"
method: GET
path: "/cases"
tags: ["Cases"]
---

# List cases for referral partner clients

`GET /cases`

Retrieves a paginated list of debt collection cases for all clients linked to the authenticated referral partner.

Case Lifecycle Stages
Cases progress through a defined lifecycle:
• **Pending contract signing** - Client hasn't signed debt collection agreement yet
• **Pending Verification Internal** - Case awaiting internal Debitura review
• **Pending Verification** - Case awaiting partner verification
• **More Info Required** - More information required from creditor
• **Collecting Quotes** - Awaiting quote from collection partner
• **Pending Quote Selection** - Quote provided by partner
• **Active** - Case is being actively collected
• **Paused** - Collection temporarily paused
• **Closed** - Case is closed (check CloseCode for reason)

Filtering Options
• **FromDate/ToDate** - Filter by case creation date range (ISO 8601)
• **ExternalTenantId** - Filter to specific client using your identifier
• **Statuses** - Filter by lifecycle status(es)
• **Query** - Search across reference numbers and debtor name

Sorting
• **Sort** - Sort field and direction (format: 'field:direction')
• Supported fields: DateCreated, GrossAmount, DueDate
• Examples: 'DateCreated:desc', 'GrossAmount:asc', 'DueDate:desc'
• Default: DateCreated:desc (newest first)

## Query parameters

- `FromDate` string, date-time
- `ToDate` string, date-time
- `ExternalTenantId` string
- `Statuses` string[]
- `Query` string
- `Page` integer
- `PageSize` integer
- `CountryIds` integer[]
- `CollectionPartnerIds` string[]
- `Sort` string

## Response `200`

Cases retrieved successfully

- DebituraWebReferralPartnerApiModelsCasesGetCasesResponse — Response model for listing cases linked to a referral partner
  - `page` DebituraDomainModelBasePageData — Paging metadata describing a paged result set.
    - `totalResults` integer — Total number of records for the query (filtered or all as applicable).
    - `pageSize` integer — How many records are returned per page.
    - `currentPage` integer — Which page number is being shown, calculated from the number of skipped items.
    - `responseCount` integer — How many records are present in the current page.
    - `totalPages` integer — Total number of pages available given Debitura.Domain.Model.Base.PageData.TotalResults and Debitura.Domain.Model.Base.PageData.PageSize. Returns 0 if Debitura.Domain.Model.Base.PageData.PageSize is 0 rather than dividing by zero.
  - `cases` DebituraWebReferralPartnerApiModelsCasesCaseItem[], nullable
    - `id` string, uuid
    - `reference` string, nullable
    - `creditorReference` string, nullable
    - `client` DebituraWebReferralPartnerApiModelsCasesCaseClientInfo — Client (creditor) info with referral-partner-specific ExternalTenantId.
      - `externalTenantId` string, nullable — Your external tenant ID for this client (the identifier you provided when linking).
      - `creditorId` string, uuid
      - `companyName` string, nullable
      - `contacts` DebituraWebReferralPartnerApiModelsCasesClientContacts — Contact information for a client, including the original onboarding user, the company office email, and all other users linked to the creditor.
        - `onboardingUser` DebituraWebReferralPartnerApiModelsCasesContactUser — A user contact associated with a creditor.
          - `email` string, nullable
          - `name` string, nullable
        - `officeEmail` string, nullable — The creditor's office email address (company-level contact).
        - `otherUsers` DebituraWebReferralPartnerApiModelsCasesContactUser[], nullable — Other users linked to this creditor account (excludes the onboarding user).
          - `email` string, nullable
          - `name` string, nullable
    - `debtor` DebituraWebReferralPartnerApiModelsCasesCaseDebtorInfo — Debtor info for the case.
      - `name` string, nullable — Debtor display name (company name, or person name if individual).
      - `country` string, nullable — Debtor's country (full name, e.g. "United Kingdom", "Denmark").
    - `grossAmount` number, double
    - `remainder` number, double
    - `currency` string, nullable
    - `lifecycle` string, nullable — Lifecycle status as human-readable description (e.g. "Active", "Closed", "Pending Verification"). Same format as InvoiceDto.Lifecycle in the external API contracts.
    - `closeCode` string, nullable — Close code description if the case is closed (e.g. "Paid", "Withdrawn by Client"), null otherwise.
    - `currentEngagementPhase` string, nullable — The current phase of the case's engagement: "Pre-legal", "Legal", or "Enforcement". A different axis from Debitura.Web.ReferralPartnerApi.Models.Cases.CaseItem.Lifecycle/Debitura.Web.ReferralPartnerApi.Models.Cases.CaseItem.CloseCode — an Active case can be in any of the three phases. Null means "no active engagement" (e.g. lead / quoting / pre-contract-signing / unassigned, or a data-consistency gap) — a distinct third state, NOT a synonym for Pre-legal. Most cases legitimately read Pre-legal; phase only leaves Pre-legal on legal/enforcement quote flows. Not guaranteed to be monotonic (an admin correction can move phase backwards). Persists after case closure — reflects the case's last-known engagement phase, not the current Lifecycle.
    - `dateCreated` string, date-time
    - `dueDate` string, date-time
    - `dateCollectionStarted` string, date-time, nullable
    - `dateFinished` string, date-time, nullable
    - `validation` DebituraDomainServicesCaseValidationCaseValidationStatusDto — Sanitized, creditor-safe projection of a case's current validation status. Safe to expose on any external surface — never contains Rationale, InternalValidationComment, InternalReview/AdminReview areas, Confidence, or EvaluationMethod.
      - `needsInfo` boolean — True when the latest validation run requires creditor action. Reads Debitura.Domain.Model.Receiveables.Invoices.Invoice.ValidationNeedsInfo directly — do not re-derive from items.
      - `creditorRespondedAt` string, date-time, nullable — When the creditor (or managing partner) last explicitly responded to a needs-info request. Null when the creditor has not yet responded, or after the case passes validation.
      - `items` DebituraDomainServicesCaseValidationCaseValidationItemDto[], nullable — Creditor-facing action items from the latest validation run. Empty when Debitura.Domain.Services.CaseValidation.CaseValidationStatusDto.NeedsInfo is false or no run exists.
        - `resolutionArea` string, nullable — Enum name of the resolution area (e.g. "ProvideDocuments", "CorrectDebtorAddress"). Always a Debitura.Domain.Services.CaseValidation.CaseValidationHelpers.CreditorFacingAreas member — never "InternalReview" or "AdminReview".
        - `description` string, nullable — Creditor-safe description of what needs to be fixed. Source: Debitura.Domain.Model.Receiveables.CaseValidation.CaseValidationRuleResult.CuratedDescription — scoring stripped.
    - `collectionPartner` string, nullable — Display name of the collection partner handling this case (e.g. "Oriel Collections"). Null if no collection partner has been assigned yet.
    - `expectedReferralRatePercentage` number, double, nullable — The expected referral fee rate as a percentage (e.g. 70.0 = 70%). For cases with a collection partner that has a per-assignment override, the override is used. Otherwise falls back to the referral link's snapshotted rate (frozen at link creation time). Null when no collection partner has been assigned yet — a rate can only be determined once routing is complete. For realised payouts with frozen rates, see `referralFeePercentageSnapshot` on the transactions endpoint.
  - `summary` DebituraWebReferralPartnerApiModelsCasesCasesSummary
    - `totalCases` integer
    - `casesThisMonth` integer
    - `byLifecycle` DebituraWebReferralPartnerApiModelsCasesLifecycleBreakdown
      - `active` integer
      - `pending` integer
      - `closed` integer
      - `paused` integer

## Other responses

- `400` — Invalid request parameters
- `500` — Internal server error

---

[API](https://skmtc.net/debitura/apis/debitura-referral-partner-api.md) · [All operations](https://skmtc.net/debitura/apis/debitura-referral-partner-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/debitura/debitura-referral-partner-api/versions/9c466e0e2bf4/schema)