---
title: "Get case detail with potential revenue breakdown"
method: GET
path: "/cases/{id}"
tags: ["Cases"]
---

# Get case detail with potential revenue breakdown

`GET /cases/{id}`

Retrieves a single case with all standard fields plus a potential revenue breakdown showing what the referral partner would earn if the full amount is collected.

## Path parameters

- `id` string, uuid, required

## Response `200`

Case retrieved successfully

- DebituraWebReferralPartnerApiModelsCasesGetCaseDetailResponse — Response model for retrieving a single case with potential revenue breakdown. Extends CaseItem fields with revenue data for referral partners.
  - `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
  - `closeCode` string, nullable
  - `currentEngagementPhase` string, nullable — The current phase of the case's engagement: "Pre-legal", "Legal", or "Enforcement". Null means no active engagement — see Debitura.Web.ReferralPartnerApi.Models.Cases.CaseItem.CurrentEngagementPhase for full semantics (not monotonic, persists after case closure).
  - `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%). Uses the per-assignment override when set, otherwise the referral link's snapshotted rate (frozen at link creation time). Null when no collection partner has been assigned yet.
  - `potentialRevenue` DebituraWebReferralPartnerApiModelsCasesCasePotentialRevenue — Breakdown of potential revenue if the full case amount is collected. All amounts are in USD; percentages are displayed as whole numbers (e.g. 9.5 = 9.5%).
    - `grossAmountUsd` number, double — Case gross amount converted to USD.
    - `successFeePercentage` number, double — Success fee percentage charged by the collection partner (e.g. 9.5).
    - `collectionPartnerRevenueUsd` number, double — GrossAmountUsd * SuccessFeePercentage / 100.
    - `platformRevenueSharePercentage` number, double — Debitura's revenue share percentage of the collection fee (e.g. 40.0).
    - `platformRevenueUsd` number, double — CollectionPartnerRevenueUsd * PlatformRevenueSharePercentage / 100.
    - `referralFeePercentage` number, double — Referral partner's share percentage of platform revenue (e.g. 50.0).
    - `referralRevenueUsd` number, double — PlatformRevenueUsd * ReferralFeePercentage / 100.

## Other responses

- `404` — Case not found
- `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)