---
title: "List organisations"
method: GET
path: "/api/v1/iqbooks/organisations"
tags: ["IQ Books — Organisations"]
---

# List organisations

`GET /api/v1/iqbooks/organisations`

## Request

- Base URL: `https://api.reconcileiq.com`
- URL: `https://api.reconcileiq.com/api/v1/iqbooks/organisations`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Lists organisations the caller is an accepted member of. Requires scope `iqbooks:read`. Note: this collection response is `{ data: [...] }` with no pagination block.

## Response `200`

Organisations.

- object
  - `data` Organisation[], required
    - `id` integer
    - `name` string
    - `trading_name` string, nullable
    - `legal_form` string, nullable
    - `country_code` string
    - `base_currency` string
    - `vat_registered` boolean
    - `vat_number` string, nullable
    - `vat_scheme` string, nullable
    - `accounting_basis` string, nullable
    - `fiscal_year_end_month` integer, nullable
    - `fiscal_year_end_day` integer, nullable
    - `registration_number` string, nullable
    - `period_locked_until` string, date, nullable
    - `role` string, nullable: Caller's membership role.
    - `account_count` integer
    - `posted_entries` integer
    - `bank_account_count` integer
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401`: Missing, invalid, or revoked API key.
- `403`: Authenticated but the key lacks the required scope.
- `429`: Per-key rate limit exceeded (120 requests / 60s window).

---

[API](https://skmtc.dev/reconcileiq/apis/reconcileiq-public-api.md) · [All operations](https://skmtc.dev/reconcileiq/apis/reconcileiq-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reconcileiq/apis/reconcileiq-public-api/revisions/5401beef8653?raw)