Create year-end DLA snapshot with S455 and BiK calculations

POSThttps://app.speybooks.com/api/v1/director-loans/snapshot

Captures a point-in-time year-end snapshot for one director: the closing balance at the period end, the S455 exposure and its deadline, and, where the balance is above the threshold, the Benefit in Kind computed by the average-balance method at the official rate, with its P11D deadline. One snapshot exists per director per period end; a duplicate is refused. The S455 deadline is nine months and one day after the period end.

Body parameters

directorIdstringoptional
Director ID (e.g. dir_1).
periodEndDatestringoptional
Accounting period end date (YYYY-MM-DD). Used to calculate the closing balance and S455 deadline.
date

Response

201Snapshot created with S455 exposure, BiK calculation, and P11D deadline.
Show response fields
balancePenceinteger
directorIdstring
periodEndDatestring
s455Statusstring

Error codes

400Validation error or invalid director ID.
404Director not found.
409Snapshot already exists for this director and period end date.