---
title: "List organizations"
method: GET
path: "/v1/organizations"
tags: ["Organization"]
---

# List organizations

`GET /v1/organizations`

Retrieves a paginated list of organizations accessible to the current user. The list includes organizations where the user has direct permissions or permissions through team membership. Results can be sorted and paginated.

## Query parameters

- `sort` 'alpha' | 'permission' | 'created'
- `order` 'asc' | 'desc'
- `page` integer, required
- `limit` integer, required
- `permission` 'admin' | 'invoicing' | 'billing' | 'invoicingOrAdmin'

## Response `200`

List of organizations

- OrganizationList
  - `items` OrganizationDto[]
    - `id` string
    - `name` string
    - `description` string
    - `image` string
    - `color` integer
    - `subscription` CustomerSubscriptionDto
      - `id` string
      - `user` string
      - `expires` integer
      - `status` integer
      - `plan` integer
      - `licenses` integer
      - `paymentOption` string
      - `business` string
      - `email` string
      - `firstname` string
      - `lastname` string
      - `vatId` string
      - `displayName` string
      - `street` string
      - `city` string
      - `state` string
      - `zip` string
      - `country` string
      - `countryIso` string
      - `language` string
      - `includeTaxForBusiness` boolean
      - `activated` boolean
      - `pastDue` boolean
      - `cancellationOffer` boolean
      - `subscriptionActive` boolean
      - `subscriptionCancelled` boolean
      - `subscriptionInactive` boolean
      - `paymentProviderActive` boolean
      - `startedTestimonial` string, date-time
      - `activationDate` string, date-time
      - `cancellationDate` string, date-time
      - `permissionAdmin` boolean
      - `valid` boolean
      - `expired` boolean
      - `validAndActivated` boolean
      - `payPalPayment` boolean
      - `stripePayment` boolean
      - `invoicePayment` boolean
      - `googlePlayPayment` boolean
      - `appleStorePayment` boolean
      - `currency` string
      - `businessCustomer` boolean
      - `euCustomer` boolean
      - `eu` boolean
      - `at` boolean
      - `ch` boolean
      - `uk` boolean
      - `product` string
      - `licenseQuantity` integer
      - `active` boolean
      - `trial` boolean
      - `cancelled` boolean
      - `member` boolean
      - `businessOrTrial` boolean
      - `pro` boolean
      - `planEnterprise` boolean
      - `planBusiness` boolean
      - `planPro` boolean
      - `planPlus` boolean
      - `planBasic` boolean
      - `monthlyPlan` boolean
      - `yearlyPlan` boolean
      - `organization` boolean
    - `user` string
    - `aiChatEnabled` boolean
    - `lastUpdate` integer
    - `created` integer
    - `deleted` boolean
    - `permission` OrganizationPermissionDto
      - `invoicing` boolean
      - `billing` boolean
      - `admin` boolean
  - `params` OrganizationListParams
    - `search` string
    - `sort` string
    - `order` string
    - `count` integer
    - `page` integer
    - `limit` integer
    - `permission` string
    - `offset` integer

## Other responses

- `401` — Not authorized

---

[API](https://skmtc.net/timesheet/apis/timesheet-api.md) · [All operations](https://skmtc.net/timesheet/apis/timesheet-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/timesheet/timesheet-api/revisions/fbe59bacb638/schema)