---
title: "List firm-managed client organizations for mapping"
method: GET
path: "/organizations"
tags: ["Organizations"]
---

# List firm-managed client organizations for mapping

`GET /organizations`

## Request

- Base URL: `https://ledgerhq.pro/api/v1`
- URL: `https://ledgerhq.pro/api/v1/organizations`
- Auth: HTTP bearer

Used after firm-level account OAuth to populate client/company mapping pickers. The OAuth token is anchored to a LedgerHQ firm; client-specific API calls still pass x-organization-id. Supports limit up to 250, cursor pagination, type=client, includeFirm, firmOrganizationId, status=active|archived (default active), and the importPicker eligibility filter. Archived companies are soft-archived (deletedAt set), not billed, and cannot be opened until reinstated.

## Query parameters

- `limit` integer
- `cursor` string
- `type` 'client' | 'firm'
- `includeFirm` boolean
- `firmOrganizationId` string, uuid
- `status` 'active' | 'archived'
- `importPicker` boolean

## Response `200`

Accessible organizations

- object
  - `firm` FirmOrganization
    - `id` string, uuid
    - `name` string
    - `role` 'owner' | 'admin' | 'staff_admin' | 'member'
  - `organizations` AccessibleOrganization[]
    - `id` string, uuid, required
    - `name` string, required
    - `slug` string
    - `workspaceType` 'firm' | 'client'
    - `firmOrganizationId` string, uuid, nullable
    - `role` 'owner' | 'admin' | 'staff_admin' | 'member', required
    - `effectiveFirmPackage` 'core' | 'tally' | 'null', nullable: Inherited firm package for companies; firm row package for firms.
    - `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
    - `autoPostEnabled` boolean: When true, activates Core AI posting or Tally AI unattended work for this bookkeeping workspace. Each firm workspace and managed company has its own switch. Bank sync, imports, analysis, and explicit actions remain available while it is off. Defaults false for new organizations.
    - `codingEmailsEnabled` boolean: Legacy stored value returned for compatibility only. It has no runtime authority and is not written by organization updates.
    - `ytdRevenue` integer: Integer cents. Example: 1250 means $12.50.
    - `ytdProfit` integer: Integer cents. Example: 1250 means $12.50.
    - `unpostedFeedCount` integer
    - `unpostedFeedTotal` integer: Integer cents. Example: 1250 means $12.50.
    - `uncodedFeedCount` integer
    - `uncodedFeedTotal` integer: Integer cents. Example: 1250 means $12.50.
    - `checkCount` integer: Unposted paper checks waiting on the Fast Coding Checks tab.
    - `disconnectedItemCount` integer: Live Plaid Items for this company that are disconnected or have broken/disconnected health. Demo Items are excluded.
    - `unmappedAccountCount` integer: Import-enabled live Plaid accounts not mapped to a ledger bank account. Demo Items are excluded.
    - `bankFeedAlert` boolean: True when disconnectedItemCount or unmappedAccountCount is greater than zero.
    - `firmPackage` 'core' | 'tally' | 'null', nullable
    - `channel` 'pro' | 'smb': Which door the account signed up through: pro (accounting firm) or smb (business owner). Audience metadata that selects copy and link targets; it gates no capability. Companies inherit it from their firm.
    - `deletedAt` string, date-time, nullable: Set when the company is soft-archived.
    - `status` 'active' | 'archived', required
  - `next_cursor` string, nullable
  - `has_more` boolean

## 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)