---
title: "Get the current organization"
method: GET
path: "/organization"
tags: ["Organizations"]
---

# Get the current organization

`GET /organization`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/organization`
- Auth: one of:
  - HTTP bearer and API key in header `x-organization-id`
  - HTTP bearer and API key in header `x-organization-id`

Returns the organization addressed by x-organization-id, including the additive effectiveFirmPackage and codingPolicy projection. LedgerHQ applies best-guess AI category posting from 1% confidence; raw firmPackage and the legacy confidence field remain for compatibility. Requires organizations:read for OAuth/agent credentials. Session-authenticated web calls retain membership access.

## Response `200`

Organization with coding policy

- object
  - `organization` OrganizationWithCodingPolicy, required: Organization row plus additive effectiveFirmPackage and codingPolicy projection. Raw firmPackage remains for compatibility.
    - `whiteLogo` string, nullable: White firm logo for selected dark surfaces.
    - `logoVariants` FirmLogoVariants: Per-surface color/white logo choices. Omitted choices default to color; PATCH merges supplied choices. Missing white artwork falls back to color on white.
      - `login` 'color' | 'white'
      - `portal` 'color' | 'white'
      - `invitation` 'color' | 'white'
      - `email` 'color' | 'white'
      - `invoiceEmail` 'color' | 'white'
      - `webReport` 'color' | 'white'
      - `pdfReport` 'color' | 'white'
      - `onboarding` 'color' | 'white'
      - `engagementLetter` 'color' | 'white'
      - `clientRequest` 'color' | 'white'
      - `bankConnection` 'color' | 'white'
      - `favicon` 'color' | 'white'
    - `clientPortalUrl` string, uri, nullable: Permanent firm-branded client login URL, shared by the firm's companies. Uses existing firm branding settings.
    - `emailSenderName` string, nullable: Name part of the firm's client email address. Guessed from the firm name on first use.
    - `clientEmailAddress` string, email, nullable: Firm workspace only. Address request emails to companies are sent from, e.g. sentinelwealth@ledgerhq.pro. Direct mail to it is forwarded to the firm contact email.
    - `id` string, uuid
    - `name` string
    - `slug` string
    - `workspaceType` 'firm' | 'client'
    - `firmOrganizationId` string, uuid, nullable
    - `firmPackage` 'core' | 'tally' | 'null', nullable: Raw stored package. Firms store core|tally; companies store null and inherit through effectiveFirmPackage.
    - `effectiveFirmPackage` 'core' | 'tally'
    - `role` 'owner' | 'admin' | 'staff_admin' | 'member': Role in the selected organization context.
    - `firmRole` 'owner' | 'admin' | 'member' | 'null', nullable: Firm role when the selected context is a managed company.
    - `accessMode` 'firm' | 'client_portal' | 'tax_read_only' | 'firm_identity_only': The authenticated access path for the selected organization.
    - `companyAccessId` string, uuid, nullable
    - `autoPostEnabled` boolean
    - `codingEmailsEnabled` boolean: Legacy stored value returned for compatibility only. It has no runtime authority and is not written by organization updates.
    - `aiAutopostMinConfidence` integer: Legacy stored value returned for compatibility only. LedgerHQ uses the 1% best-guess posting minimum and ignores writes to this field.
    - `codingPolicy` OrganizationCodingPolicy
      - `effectiveFirmPackage` 'core' | 'tally', required: Firm-owned commercial package that owns bookkeeping automation. Companies inherit this from their firm.
      - `mode` 'core_confidence' | 'tally_ordinary', required: core_confidence and tally_ordinary use the bookkeeping workspace activation switch with LedgerHQ's 1% best-guess confidence minimum.
      - `autoPostEnabled` boolean, required: Stored bookkeeping-workspace activation switch. Effective for Core AI posting and Tally AI unattended work on firm and managed-company workspaces.
      - `aiAutopostMinConfidence` integer, required: Fixed LedgerHQ confidence floor, currently 70. Legacy writes are ignored_deprecated.
      - `autoPostEnabledEffect` 'effective' | 'ignored_deprecated', required
      - `aiAutopostMinConfidenceEffect` 'ignored_deprecated', required

## Other responses

- `default`: Error response

---

[API](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api.md) · [All operations](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ledgerhq-pro/apis/ledgerhq-bookkeeping-api/revisions/9a8269f0a586?raw)