Record a Director Loan Account transaction

POST https://app.speybooks.com/api/v1/director-loans/

Records a DLA transaction with automatic double-entry journal creation. The loanType determines the sign convention and journal accounts — the API resolves the correct debit/credit accounts automatically.

Request Fields

  • directorId — prefixed director ID (required)
  • date — transaction date YYYY-MM-DD (required)
  • description — description, max 500 chars (required)
  • amountPence — integer in pence, non-zero (required). Must be positive for company→director types, negative for director→company types
  • loanType — one of: loan_to_director, loan_from_director, repayment_to_company, repayment_to_director, dividend_offset, salary_offset, write_off (required)
  • notes — optional notes, max 2000 chars
  • createJournal — whether to create the double-entry journal (default: true)

Body parameters

amountPence integer optional
Amount in pence. Positive = company to director, negative = director to company. Sign must match loanType.
createJournal boolean optional
Whether to create double-entry journal entries. Defaults to true.
date string optional
Transaction date (YYYY-MM-DD).
date
description string optional
Transaction description (1-500 characters).
directorId string optional
Director ID (e.g. dir_1).
loanType string optional
Type of DLA transaction. Determines the journal account codes and sign convention.
loan_to_directorloan_from_directorrepayment_to_companyrepayment_to_directordividend_offsetsalary_offsetwrite_off
notes string optional
Optional notes (max 2000 characters).

Response

201 DLA transaction recorded. Includes journal transaction ID and any S455/bed-and-breakfasting warnings.
Show response fields
id string
transactionId string

Error codes

400 Validation error or amount sign mismatch with loan type.
404 Director not found.