Get DLA balance for a single director

GEThttps://app.speybooks.com/api/v1/director-loans/balance/{directorId}

Returns the DLA balance for a single director with full exposure detail: the director's own balance, the connected-persons balance, the aggregated total, the S455 position, and a warning level. The warning level is green when the director is not overdrawn, red when a year-end snapshot records an S455 amount that has become payable, and amber otherwise.

Path parameters

directorIdstringrequired
Director ID (e.g. dir_1). Must use the director prefix.

Response

200Detailed DLA balance with S455 exposure, BiK calculation, connected persons aggregation, and warning level (green/amber/red).
Show response fields
aggregatedBalancePenceinteger
balancePenceinteger
bikobject
Show child attributes
applicableboolean
connectedPersonsBalancePenceinteger
directorIdstring
fullNamestring
s455object
Show child attributes
exposedboolean
statusstring
transactionCountinteger
warningLevelstring

Error codes

400Invalid director ID format.
404Director not found.