/recollection-cases

post

https://api-sandbox.getdefacto.com/recollection-cases

Open a recollection case

When the borrower is late to repay his loans or bills, you must open a recollection case to start taking
actions to recover the debt.
This endpoint will let you open a new recollection case for a business (debtor).
You need to indicate at least one loan or bill (ids).
For the follow up of the case by the recollection agent, you need to add a task to be done in the future.
The task MUST have a name and a due date, the description is optional.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

debtor_business

object

required

Debtor business identifier who owes recollected debt

loan_ids

array of uuids

required

Loans that are being recollected

loan_ids*

payload

string

stage

string | null

enum

Defaults to null

Headers

X-Decision-Id

uuid

required

UUID of an approved governance Decision whose planned_operations list this endpoint together with the exact request payload. The matching planned step must not yet have been executed. Planned operations may contain {{step.<n>.json.<path>}} references to earlier steps' responses: the gate resolves them against the recorded outputs before matching, so send the RESOLVED body and fire steps in order — a step whose references are not yet resolvable cannot match. Required for MCP callers; HumanReviewer callers bypass the gate by default.

Responses

400

Missing X-Decision-Id header or value is not a valid UUID.

403

Decision is not approved, the calling identity does not match the proposer, no planned operation matches this endpoint + payload, the matching step has already been executed, or the caller is not a recognised proposing Operator.

404

No Decision exists for the supplied X-Decision-Id.

201