---
title: "House rules: settings, jurisdictions and templates"
method: GET
path: "/api/v1/settings"
tags: ["Account"]
---

# House rules: settings, jurisdictions and templates

`GET /api/v1/settings`

## Request

- Base URL: `http://localhost:5180`
- URL: `http://localhost:5180/api/v1/settings`
- Auth: API key in cookie `better-auth.session_token`

Everything the owner has decided. `settings.automation` is the trust promise as data: the master switch, the default tier, quiet hours and every spend cap that bounds what Dardaris may do without asking. Money is integer cents.

## Response `200`

The signed-in owner’s settings.

- object
  - `ok` unknown, required
  - `data` object, required
    - `settings` object, required: Currency, locale, presentation, and the automation guardrails the AI runs inside.
      - `currency` string, required
      - `locale` string, required
      - `timezone` string, required
      - `theme` 'light' | 'dark' | 'system', required
      - `density` 'comfortable' | 'compact', required
      - `fiscalYearStartMonth` number, required: 1 is January.
      - `automation` object, required
        - `enabled` boolean, required: The master switch. Off means the AI observes and suggests but never acts.
        - `defaultTier` 'auto' | 'review' | 'notify', required: The trust level a workflow runs at unless it sets its own. A workflow may tighten this, never loosen it.
        - `quietHours` object, required: No tenant is contacted outside these hours. Times are 24-hour `HH:MM` in the stated timezone.
          - `from` string, required
          - `to` string, required
          - `timezone` string, required
        - `globalSpendCap` integer, required: Any single action costing more than this always asks the owner first, whatever tier it runs at.
        - `maintenanceAutoApproveUnder` integer, required: A repair below this may be approved without asking. At or above it, the owner decides.
        - `reconciliationAutoThreshold` number, required: 0 to 1. While the placement automation is on, an incoming payment Dardaris is at least this sure of is placed against what it pays. Anything lower waits for the owner.
        - `approvalExpiryHours` number, required
        - `onApprovalExpiry` 'execute' | 'cancel' | 'hold', required: What happens to a request the owner never answers.
        - `allowedChannels` string[], required: The channels the AI may use unattended.
        - `requireApprovalFor` string[], required: Action kinds that always need a human, however cheap they are. This is where anything legally consequential belongs.
        - `replyMode` 'draft' | 'send': What happens to a reply Dardaris wrote. `draft` leaves it on the thread to be read and sent; `send` posts it, and only where the master switch, the workflow tier and `requireApprovalFor` have all already said yes. Absent on a settings block written before the choice existed, which reads as `draft`.
        - `digestFrequency` 'daily' | 'weekly' | 'never', required
        - `digestTime` string, required
      - `onboardingVersion` string: The welcome and tour version this owner has finished or skipped. Absent until they have.
      - `demo` boolean: True while the portfolio is the worked example. Absent on a portfolio provisioned before the flag existed, which is a demo.
    - `jurisdictions` object[], required: The legal packs available. A building is read against one of these, never against a rule hardcoded in a screen.
      - `id` string, required: `be-fl`, `be-bru`, `nl`, `fr`, `generic`.
      - `name` string, required
      - `countryCode` string, required
      - `region` string
      - `currency` string, required
      - `languages` string[], required
      - `vatRates` object, required
        - `standard` number, required: A decimal ratio. 0.21 is 21%.
        - `reduced` number[], required
        - `residentialLettingExempt` boolean, required: True where letting a home carries no VAT at all.
        - `verified` boolean: False where no rate was loaded for this country, which makes the figures placeholders like any other unconfirmed rule.
        - `note` string
      - `leaseTypesCovered` object: The lease types the rules below were researched against. A pack written for homes says nothing about a shop or a parking bay.
        - `value` string[], required
        - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
        - `note` string
        - `source` string
      - `deposit` object, required
        - `maxMonths` object, required
          - `value` number, required: The statutory cap, in months of rent.
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `permittedForms` object, required
          - `value` string[], required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `mustBeBlocked` object, required
          - `value` boolean, required: True where the deposit has to sit in a blocked account in the tenant’s name.
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `releaseDeadlineDays` object, required
          - `value` number, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `interestToTenant` object, required
          - `value` boolean, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `capped` object: False where the law sets no ceiling, and maxMonths caps nothing.
          - `value` boolean, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `maxMonthsFurnished` object
          - `value` number, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `custody` object: Where the money has to sit once paid.
          - `value` 'landlord' | 'separate_account' | 'blocked_account' | 'scheme' | 'public_body', required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `custodian` object: The scheme or public body, by name.
          - `value` string, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `lodgeWithinDays` object: Days from receipt by which it has to be lodged or protected.
          - `value` number, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `instalments` object
          - `value` number, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
      - `indexation` object, required
        - `allowed` object, required
          - `value` boolean, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `basis` object, required
          - `value` string, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `indexName` object, required
          - `value` string, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `formula` object, required
          - `value` string, required: The formula in words, shown next to the computed figure so the owner can check it.
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `earliestApplication` object, required
          - `value` 'anniversary' | 'any_time', required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `requiresNotice` object, required
          - `value` boolean, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `retroactiveMonths` object, required
          - `value` number, required: How far back an increase may be claimed once it is applied late.
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
      - `registration` object, required
        - `required` object, required
          - `value` boolean, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `responsibleParty` object, required
          - `value` 'landlord' | 'tenant' | 'either', required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `deadlineDays` object, required
          - `value` number, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `cost` object, required
          - `value` integer, required: Money, always in integer cents. €1,250.00 is 125000.
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `penalty` object, required
          - `value` string, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
      - `notice` object, required
        - `byTenantMonths` object, required
          - `value` object, required: Notice in months, keyed by lease type.
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `byLandlordMonths` object, required
          - `value` object, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `earlyExitIndemnityMonths` object, required
          - `value` number[], required: Indemnity in months of rent, indexed by the year of the lease the tenant leaves in.
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
      - `requiredCertificates` object, required
        - `value` object[], required
          - `type` string, required
          - `validityYears` number
          - `note` string
        - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
        - `note` string
        - `source` string
      - `serviceCharges` object, required
        - `settlementDeadlineMonths` object, required
          - `value` number, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `tenantMayInspectInvoices` object, required
          - `value` boolean, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `permittedAllocationKeys` object, required
          - `value` string[], required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
      - `arrears` object, required
        - `stages` object, required
          - `value` object[], required: The escalation path that carries legal weight here, in order.
            - `stage` string, required
            - `afterDays` number, required
            - `requiresRegisteredPost` boolean, required
            - `note` string
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `lateInterestRate` object, required
          - `value` number, required: A decimal ratio. 0.21 is 21%.
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `court` object, required
          - `value` string, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `conciliationMandatory` object, required
          - `value` boolean, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
      - `shortTermRental` object, required
        - `registrationRequired` object, required
          - `value` boolean, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `nightCapPerYear` object, required
          - `value` number, nullable, required: Null where there is no annual cap on letting nights.
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `touristTaxPerPersonPerNight` object, required
          - `value` integer, required: Money, always in integer cents. €1,250.00 is 125000.
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `touristTaxRemittedBy` object, required
          - `value` 'host' | 'platform' | 'mixed', required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `vatApplies` object, required
          - `value` boolean, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
        - `guestRegistrationRequired` object, required
          - `value` boolean, required
          - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
          - `note` string
          - `source` string
      - `smokeDetectorsRequired` object, required
        - `value` boolean, required
        - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
        - `note` string
        - `source` string
      - `dataRetentionMonths` object, required
        - `value` number, required
        - `verified` boolean, required: False when the figure could not be verified, which the product surfaces to the owner as "confirm this".
        - `note` string
        - `source` string
      - `notes` string[]
    - `templates` object[], required: The correspondence templates, also returned in full by /templates.
      - `id` string, required: Stable record id, e.g. `lse_012`.
      - `key` string, required
      - `name` string, required
      - `category` 'rent' | 'arrears' | 'lease' | 'maintenance' | 'compliance' | 'guest' | 'general' | 'report', required
      - `channel` 'email' | 'sms' | 'whatsapp' | 'phone' | 'portal' | 'post', required
      - `subject` object
      - `body` object, required: The body per language, keyed by ISO 639-1 code. The four the product ships wording in are always here; a language the owner added may not be, so read it through a fallback.
      - `variables` string[], required: The merge fields this template expects to be given.
      - `isSystem` boolean, required
      - `tone` 'formal' | 'neutral' | 'friendly', required
      - `hasLegalBoilerplate` boolean, required: True when the wording is legally fixed and must not be paraphrased by the AI.
      - `usageCount` number, required
      - `lastEditedAt` string: ISO 8601 timestamp.
  - `meta` object, required
    - `requestId` string, required: Echoed in the x-request-id header. Quote it in a bug report.

---

[API](https://skmtc.dev/dardaris/apis/dardaris-api.md) · [All operations](https://skmtc.dev/dardaris/apis/dardaris-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dardaris/apis/dardaris-api/revisions/4aff33835c73?raw)