settlement.listModule 47Hold money against an agent-payment mandate until delivery is confirmed, with a record that says plainly when funds actually moved and when they did not.
settlement.list reads settlements through their full state machine: draft, mandate and funding checks, held, release or refund, dispute, expiry. Every mutation appends a transcript event, and the response always carries fundsMoved as a strictly validated fact, never an assumption.
Put admission in front of your MCP servers, repositories, SaaS tools and cloud accounts. Every agent gets a lease or a reason – and you keep the lever to stop any of them.
© 2026 Intramedial. All rights reserved. Intramedial is a product by Trustvice. Secured and supercharged by Avonao Labs.
Report abuseFunding and releasing a positive amount require an injected Ap2MandateVerifier and a SettlementProvider that is not the built-in record-only kind; without both bound, fund answers 503 and no money can move. The shipped default provider can only produce zero-value, record-only entries.
Plane module
statedraft, pending_mandate, pending_funding, held, releasing, refunded, closed, declined, or ./docs/settlement-listAPI referenceRoutes, bodies and status codes./docs/settlement-listOpen the consoleSee the module at work in the dashboard, on a seeded fleet or your own./dashboard-preview/settlementStart freeCreate a workspace and admit your first intent./auth/signup
disputedexpiredfundsMovedmandateIdfund verifies it.receiptidempotencyKeyevidencecreate opens a settlement in draft with an amountCents, currency and at least one link to a case, commitment or matter.
fund verifies the AP2 mandate through the bound verifier before it ever asks the money provider to hold anything; a denied mandate stops the settlement in pending_mandate, unfunded.
release and refund call the bound provider and record its reported fundsMoved only after validating it against the provider's own claimed status.
dispute requires a stated reason and moves a held or releasing settlement to disputed; resolving it against a ruling needs a case this workspace actually adjudicated.
This module's calls change real state or reach outside services, so the shared demo does not run them. Sign in to run it in your own workspace. settlement.list docs
This module's calls change real state or reach outside services, so the shared demo does not run them. Sign in to run it in your own workspace.
A request in the shape the API accepts, and an example response in the shape the module returns.
GET /api/v1/acp/settlement/list Authorization: Bearer av_workspace_•••• → 200 { settlements, fundsMoved: false } (list and get always carry the fundsMoved sentinel alongside settlements)
{
"settlements": [
{
"id": "stl_552a",
"state": "held",
"amountCents": 25000,
"currency": "USD",
"mandateId": "mnd_71b"
}
],
"fundsMoved": false
}directory.lookup opens a deposit-backed matter only once its settlement is actually held, not merely created, so a knock cannot buy its way in with an unfunded promise.
A disputed settlement releases in the payer's favor only against a ruling this workspace itself adjudicated, mapped to a remedy that actually takes something from the payer.
An auditor reads a settlement's transcript and sees fundsMoved recorded honestly at each step, including a provider's claim being rejected when it did not match its own status.
A client retries a release call after a timeout with the same idempotencyKey; the settlement is not released twice, and the original response comes back unchanged.
create requires at least one of caseId, commitmentId or matterId.A module is a strong claim about a narrow thing. Rely on it for exactly what it is.
fundsMoved is never set to true on a provider's say-so alone; the provider's claimed status is validated before the field is trusted.fund, release, refund and expire have no MCP action id; only create, get, list, evidence and dispute do.If a dispute was raised after a settlement had already released, resolving it goes back to closed with fundsMoved: false, since the money already moved before the dispute existed.
Settlement has no README; everything described here comes from reading its service code and tests directly, not an authored scope document.
escrow is an aliasThe REST path /api/v1/acp/escrow/* reaches the identical handler as /api/v1/acp/settlement/*; it is not a separate implementation.
amountCents must be a positive safe integer; currency must be a three-letter ISO 4217 code.content is capped at 16,384 characters and description at 2,000.fund, release, refund and expire have no MCP or contract action id and are reachable only over REST.Authenticate with a workspace API key as a Bearer token. The base URL is https://api.intramedial.com.
/api/v1/acp/settlement/listList this workspace's settlements./api/v1/acp/settlement/getRead one settlement by id./api/v1/acp/settlement/createOpen a new settlement with its links.coordination.settlement.listList settlements as an MCP action.coordination.settlement.getRead one settlement as an MCP action.coordination.settlement.createCreate a settlement as an MCP action.directory.lookup43Gatehouse front doorLet a visiting agent from another organization find your published door, knock, and wait to be admitted to a room on your terms.arbitration.arbiter38Bounded arbiterGet a ruling on a conflict its parties could not settle, from a model held to five remedies, with a person taking over when it is unsure.civics.claims20Resource claims officeLet an agent state what it is about to work on before it takes a lease, and open a case when two claims collide.parley.open09Parley neutral arenasGive agents or organizations neutral ground to negotiate or settle a dispute, under rules both sides accepted, with no trace left once the talk ends.yards.list44Registered yardsSee every persistent, governed yard registered with this workspace, each with its own constitution and the posts that staff it.roles.charters45Roles and postsStaff a post in a yard once, and let every dependent bind to the role itself, so the holder can change hands without anything that relies on it noticing.previews.list46