/v1/accounting/deals/{id}/detailRead a ledger deal in full
Everything hanging off one funded deal in a single read: the deal and its rollup, every stake (who is entitled to a share, and what each has collected, drawn and may still draw), its costs, the bank allocations that paid it, and its payout requests. What the deal's accounting panel opens on, and the closest thing here to "show me this deal's reconciliation". Not a snapshot: the five reads run in five transactions, so an allocation landing mid-request can show a rollup one row ahead of the list beneath it — stale, never wrong, so refetch rather than building an invariant on the five agreeing. Answered in the CALLER's view, named in view: books (an admin or an accounting grant) is the whole agreement; own and team are a participant's — only deals they hold a stake on or are assigned to, with the house's side (commissionMinor, psfMinor, the rollup, costs, notes) left at zero and mine carrying their own stake's totals (a team lead's includes the reps they lead). A deal outside that reach is a not-found. Without the books, splits holds only the caller's own stake (and a team lead's reps'), payouts only the caller's own requests, and costs and allocations are empty.
Access class: workspace.
Send request
Use the documented inputs to call this endpoint directly.
Parameters
Values are applied to the request and the example on the right.
Responses
the action's answer
{
"data": {
"allocations": [
{
"allocatedOn": "string",
"allocationType": "string",
"amountMinor": "string",
"bankTransactionId": "",
"createdAt": "string",
"currency": "string",
"dealId": "",
"detail": "string",
"id": "",
"notes": "string",
"updatedAt": "string"
}
],
"costs": [
{
"amountMinor": "string",
"category": "string",
"createdAt": "string",
"currency": "string",
"dealId": "",
"description": "string",
"detail": "string",
"id": "",
"paidAt": "string",
"status": "string",
"updatedAt": "string",
"vendor": "string",
"voidReason": "string",
"voidedAt": "string"
}
],
"deal": {
"mine": "string",
"rollup": "string",
"view": "string"
},
"payouts": [
{
"availableAtRequestMinor": "string",
"bankTransactionId": "",
"createdAt": "string",
"currency": "string",
"dealId": "",
"decidedAt": "string",
"decidedBy": "string",
"decisionReason": "string",
"destination": "string",
"detail": "string",
"id": "",
"notes": "string",
"paidAt": "string",
"payoutMethodId": "",
"requestedAmountMinor": "string",
"requestedAt": "string",
"requestedBy": "string",
"splitId": "",
"status": "string",
"updatedAt": "string"
}
],
"splits": [
{
"availability": "string"
}
]
}
}a refusal: {"error": "<what a person needs to read>"}. 401 no credential, 402 the plan does not include this, 403 the seat does not, 404 the thing does not exist or is not yours to see.
{
"error": "string"
}