---
title: "The signed-in user, their team, its banks and its limits"
method: GET
path: "/api/v1/team"
tags: ["Team"]
---

# The signed-in user, their team, its banks and its limits

`GET /api/v1/team`

## Request

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

Answers only for the session that asked. `settings.automation.globalSpendCap` is the ceiling above which any single action asks the owner first, whatever tier it runs at.

## Response `200`

The user and everything the team is bounded by.

- object
  - `ok` unknown, required
  - `data` object, required
    - `user` object, required: The signed-in user, as the `users` row holds them.
      - `id` string, required: Stable record id, e.g. `lse_012`.
      - `name` string, required
      - `email` string, required
      - `phone` string
      - `language` 'en' | 'nl' | 'fr' | 'de', required: One of the four the product itself authors wording in: the clause library, the seeded messages, the words on a notice.
      - `createdAt` string, required: ISO 8601 timestamp.
    - `team` object, required: The legal entity that holds title: a personal name, an SPV, an SCI, a BV. `shares` says who owns it and in what proportion.
      - `id` string, required: Stable record id, e.g. `lse_012`.
      - `name` string, required
      - `legalForm` 'individual' | 'company' | 'partnership' | 'trust', required: The legal owning entity that holds title: a personal name, an SPV, an SCI, a BV.
      - `taxId` string
      - `registrationNumber` string
      - `contactEmail` string
      - `address` object, required
        - `line1` string, required
        - `line2` string
        - `postcode` string, required: Empty where the country has no postcodes, as in the United Arab Emirates. Left out of a change, it is written empty.
        - `city` string, required
        - `region` string
        - `country` string, required
        - `countryCode` string, required: ISO 3166-1 alpha-2. It decides which jurisdiction pack applies.
        - `lat` number
        - `lng` number
      - `shares` object[], required: Who owns the entity and in what proportion.
        - `userId` string, required: Stable record id, e.g. `lse_012`.
        - `bps` number, required: Share in basis points. 10000 is 100%.
      - `vatRegistered` boolean, required
      - `createdAt` string, required: ISO 8601 timestamp.
      - `updatedAt` string, required: ISO 8601 timestamp.
    - `members` object[], required: Everybody on the team, invitations included.
      - `id` string, required: Stable record id, e.g. `lse_012`.
      - `teamId` string, required: Stable record id, e.g. `lse_012`.
      - `userId` string: Stable record id, e.g. `lse_012`.
      - `permissions` 'owner' | 'member', required
      - `pendingEmail` string
      - `invitedByUserId` string: Stable record id, e.g. `lse_012`.
      - `name` string, required
      - `email` string, required
      - `createdAt` string, required: ISO 8601 timestamp.
      - `updatedAt` string, required: ISO 8601 timestamp.
    - `bankAccounts` object[], required: Balances are integer cents. A `deposit_escrow` account is blocked money and is never treated as income.
      - `id` string, required: Stable record id, e.g. `lse_012`.
      - `teamId` string, required: Stable record id, e.g. `lse_012`.
      - `label` string, required
      - `iban` string, required
      - `bic` string
      - `currency` string, required
      - `purpose` 'operating' | 'deposit_escrow' | 'reserve' | 'personal', required: Deposits sit in a blocked escrow account, so their balance is never treated as income.
      - `balance` integer, required: Money, always in integer cents. €1,250.00 is 125000.
      - `lastSyncedAt` string: ISO 8601 timestamp.
    - `jurisdictions` object[], required: The legal rules in play across the portfolio. Every figure carries `verified`, so an unconfirmed rule reads as one.
      - `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[]
    - `settings` object, required: Currency, locale, fiscal year, and `automation`, which is the whole trust promise as data: the spend cap, the tier, the quiet hours and what always needs a human.
      - `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.
  - `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)