DEdebitura
Cases

Fetch case by ID

Changed on

Returns detailed case information for a specific case ID (GUID).

Access Control: Only returns cases where you are the collection partner, or test/demo cases where you are the managing partner. For managed production cases, use /managed-cases/{id} instead.

Response Includes:

  • Case details (reference, amount, currency, status, lifecycle stage)
  • Debtor information (name, address, contact details, company/private type)
  • Creditor information
  • Collection partner assignment details
  • Financial breakdown (principal, interest, fees)
  • Important dates (creation, assignment, due dates)
  • Geographic information (jurisdiction, country)
get/cases/{id}

Request

  • Base URL
    https://collectionpartner-api.debitura.com
  • URL
    https://collectionpartner-api.debitura.com/cases/{id}
  • Auth
    API key in header XApiKey

Path parameters

idstring uuid required

Response

Case found

idstring uuid
dateCreatedstring date-time
dateUpdatedstring date-time nullable
referencestring nullable
creditorReferencestring nullable
creditorCommentsstring nullable
claimDescriptionstring nullable
grossAmountnumber double
remaindernumber double
interestFeesnumber double
reminderFeesnumber double
collectionFeesnumber double
totalAddedFeesnumber double
currencystring nullable
isTestCaseboolean
lifecyclestring nullable
dueDatestring date-time
datestring date-time
dateFinishedstring date-time nullable
dateCollectionStartedstring date-time nullable
closeCodestring nullable
currentEngagementPhasestring nullable

The current phase of the case's engagement: "Pre-legal", "Legal", or "Enforcement". A different axis from Lifecycle/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) — this is 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 (e.g. Legal back to Pre-legal).

Persists after case closure — reflects the case's last-known engagement phase, not the current Lifecycle. Note: this is a different field from a lead quote's own offered phase (the phase a partner's quote proposes to work the case at, if this case ever went through a quote flow) — this field is the case-level phase of its actual engagement, not a quote's terms.

claimTypestring nullable

The type of claim for this case (e.g. "Unpaid Invoice", "Loan Repayment", "Breach of Contract"). Null if not set.

creditorDivisionIdstring uuid nullable
blendedAgeUpliftPointsnumber double nullable

MULTI-INVOICE AGE BUCKET PRICING Calculated blended age uplift percentage points (0-20) for multi-invoice cases. Shows the additional fee percentage added due to invoice age. Formula: ((A12-A24)×10 + A24×20) / Total Principal Null for single-invoice cases (age uplift is calculated from due date instead).

preLegalSuccessFeenumber double nullable

PRE-LEGAL SUCCESS FEE The total pre-legal success fee percentage for this case. Includes base fee + age-based uplift (blended or single-invoice). Null if pricing has not been calculated yet or if case is not in pre-legal phase. Example: 20.5 represents 20.5% success fee.

solutionUrlstring nullable

When the case is created with allowPendingContracts=true and required contracts are unsigned, this URL points to the signing page. Null when contracts are already signed or not applicable.

exclusivePeriodEndDatestring date-time nullable

The date the exclusive collection period ends (or ended). Null if no collection period has been created for this case (e.g. custom-terms cases). Use GET /cases/{id}/exclusive-period for the full chain including extensions.

disputeStatusstring nullable

Whether the claim is disputed by the debtor. One of: "Yes, the claim is disputed", "No, the claim is not disputed", or "Don't Know". Null when the dispute status has not been set on the case.

Example response

{
  "debtor": {
    "type": "Company",
    "name": "Pacific Trading LLC",
    "contactPerson": "John Smith",
    "companyRegistrationNumber": "47-1234567",
    "address": "123 Market Street, Suite 400",
    "zipCode": "94105",
    "city": "San Francisco",
    "state": "California",
    "stateAlpha2": "CA",
    "countryAlpha2": "US",
    "country": "United States",
    "email": "accounts@pacifictrading.com",
    "phone": "+1 415 555 0123"
  }
}

Changes

  • 460a861d7d9bRevision changes
    • info

      response property collectionPartner/surveyCadenceMode deprecated (media type: text/plain)

    • info

      response property collectionPartner/surveyCadenceMode deprecated (media type: application/json)

    • info

      response property collectionPartner/surveyCadenceMode deprecated (media type: text/json)