Organisation

Every SpeyBooks tenant is an organisation. The organisation record holds the company identity (name, VAT number, company number, address) and the operational settings that govern how the platform behaves (currency, VAT scheme, fiscal year, invoice and quote numbering).

Profile and settings

The record has two parts, each with its own update endpoint:

The profile is the company identity: name, VAT and company numbers, contact details, address, and business type. It is updated through PUT /organisation.

The settings are operational: currency, VAT scheme, fiscal year start, and the invoice and quote numbering defaults. They are updated through PUT /organisation/settings.

GET /organisation returns both parts together.

Address shape: read versus write

GET /organisation returns the address as a nested object (address: { line1, city, ... }) for display. PUT /organisation expects the address as flat top-level fields (addressLine1, addressLine2, city, region, postalCode, country). Submitting the nested address object to the PUT endpoint is a validation error.

Identifier and scope

The organisation id is a UUID and is not prefixed. All access is scoped to your own organisation.

VAT scheme

The VAT scheme is one of not_registered, standard, or flat_rate, set through the settings endpoint. How VAT is calculated for returns is covered in the VAT Returns guide; this resource records the scheme rather than computing from it.

→ The Organisation object

Endpoints

GEThttps://app.speybooks.com/api/v1/organisation/Get organisation details and settingsPUThttps://app.speybooks.com/api/v1/organisation/Update organisation profilePOSThttps://app.speybooks.com/api/v1/organisation/accounting-periodSet the accounting period from Companies HousePOSThttps://app.speybooks.com/api/v1/organisation/accounting-period/previewPreview the accounting period from Companies HousePUThttps://app.speybooks.com/api/v1/organisation/settingsUpdate organisation settings