---
title: "List Organization"
method: GET
path: "/organization/list"
tags: ["organization management"]
---

# List Organization

`GET /organization/list`

Get a list of organizations with optional filtering.

Parameters:
    org_id: Optional[str]
        Filter organizations by exact organization_id match
    org_alias: Optional[str]
        Filter organizations by partial organization_alias match (case-insensitive)

Example:
```
curl --location --request GET 'http://0.0.0.0:4000/organization/list?org_alias=my-org'         --header 'Authorization: Bearer sk-1234'
```

Example with org_id:
```
curl --location --request GET 'http://0.0.0.0:4000/organization/list?org_id=123e4567-e89b-12d3-a456-426614174000'         --header 'Authorization: Bearer sk-1234'
```

## Query parameters

- `org_id` string, nullable — Filter organizations by exact organization_id match
- `org_alias` string, nullable — Filter organizations by partial organization_alias match. Supports case-insensitive search.

## Response `200`

Successful Response

- LiteLLMOrganizationTableWithMembers[]
  - `organization_id` string, nullable
  - `organization_alias` string, nullable
  - `budget_id` string, required
  - `spend` number
  - `metadata` object, nullable
  - `models` string[], required
  - `created_by` string, required
  - `updated_by` string, required
  - `users` LiteLLMUserTable[], nullable
    - `user_id` string, required
    - `max_budget` number, nullable
    - `spend` number
    - `model_max_budget` object, nullable
    - `model_spend` object, nullable
    - `user_email` string, nullable
    - `user_alias` string, nullable
    - `models` unknown[]
      - unknown
    - `tpm_limit` integer, nullable
    - `rpm_limit` integer, nullable
    - `user_role` string, nullable
    - `organization_memberships` LiteLLMOrganizationMembershipTable[], nullable
      - `user_id` string, required
      - `organization_id` string, required
      - `user_role` string, nullable
      - `spend` number
      - `budget_id` string, nullable
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `user` unknown
      - `litellm_budget_table` LiteLLMBudgetTable — Represents user-controllable params for a LiteLLM_BudgetTable record. Budget-write paths use `model_fields.keys()` on this class as an allowlist for user input. Keep server-managed fields (e.g. `budget_reset_at`) on `LiteLLM_BudgetTableFull` so they aren't user-settable.
        - `budget_id` string, nullable
        - `soft_budget` number, nullable
        - `max_budget` number, nullable
        - `max_parallel_requests` integer, nullable
        - `tpm_limit` integer, nullable
        - `rpm_limit` integer, nullable
        - `model_max_budget` object, nullable
        - `budget_duration` string, nullable
        - `allowed_models` string[], nullable
      - `user_email` string, nullable
    - `teams` string[]
    - `sso_user_id` string, nullable
    - `budget_duration` string, nullable
    - `budget_reset_at` string, date-time, nullable
    - `metadata` object, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `object_permission` LiteLLMObjectPermissionTable — Represents a LiteLLM_ObjectPermissionTable record
      - `object_permission_id` string, required
      - `mcp_servers` string[], nullable
      - `mcp_access_groups` string[], nullable
      - `mcp_tool_permissions` object, nullable
      - `vector_stores` string[], nullable
      - `agents` string[], nullable
      - `agent_access_groups` string[], nullable
      - `mcp_toolsets` string[], nullable
      - `blocked_tools` string[], nullable
      - `search_tools` string[], nullable
  - `litellm_budget_table` LiteLLMBudgetTable — Represents user-controllable params for a LiteLLM_BudgetTable record. Budget-write paths use `model_fields.keys()` on this class as an allowlist for user input. Keep server-managed fields (e.g. `budget_reset_at`) on `LiteLLM_BudgetTableFull` so they aren't user-settable.
    - `budget_id` string, nullable
    - `soft_budget` number, nullable
    - `max_budget` number, nullable
    - `max_parallel_requests` integer, nullable
    - `tpm_limit` integer, nullable
    - `rpm_limit` integer, nullable
    - `model_max_budget` object, nullable
    - `budget_duration` string, nullable
    - `allowed_models` string[], nullable
  - `object_permission` LiteLLMObjectPermissionTable — Represents a LiteLLM_ObjectPermissionTable record
    - `object_permission_id` string, required
    - `mcp_servers` string[], nullable
    - `mcp_access_groups` string[], nullable
    - `mcp_tool_permissions` object, nullable
    - `vector_stores` string[], nullable
    - `agents` string[], nullable
    - `agent_access_groups` string[], nullable
    - `mcp_toolsets` string[], nullable
    - `blocked_tools` string[], nullable
    - `search_tools` string[], nullable
  - `object_permission_id` string, nullable
  - `members` LiteLLMOrganizationMembershipTable[]
    - `user_id` string, required
    - `organization_id` string, required
    - `user_role` string, nullable
    - `spend` number
    - `budget_id` string, nullable
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `user` unknown
    - `litellm_budget_table` LiteLLMBudgetTable — Represents user-controllable params for a LiteLLM_BudgetTable record. Budget-write paths use `model_fields.keys()` on this class as an allowlist for user input. Keep server-managed fields (e.g. `budget_reset_at`) on `LiteLLM_BudgetTableFull` so they aren't user-settable.
      - `budget_id` string, nullable
      - `soft_budget` number, nullable
      - `max_budget` number, nullable
      - `max_parallel_requests` integer, nullable
      - `tpm_limit` integer, nullable
      - `rpm_limit` integer, nullable
      - `model_max_budget` object, nullable
      - `budget_duration` string, nullable
      - `allowed_models` string[], nullable
    - `user_email` string, nullable
  - `teams` LiteLLMTeamTable[]
    - `team_alias` string, nullable
    - `team_id` string, required
    - `organization_id` string, nullable
    - `admins` unknown[]
      - unknown
    - `members` unknown[]
      - unknown
    - `members_with_roles` Member[]
      - `user_id` string, nullable — The unique ID of the user to add. Either user_id or user_email must be provided
      - `user_email` string, nullable — The email address of the user to add. Either user_id or user_email must be provided
      - `role` 'admin' | 'user', required — The role of the user within the team. 'admin' users can manage team settings and members, 'user' is a regular team member
    - `team_member_permissions` string[], nullable
    - `metadata` object, nullable
    - `tpm_limit` integer, nullable
    - `rpm_limit` integer, nullable
    - `max_budget` number, nullable
    - `soft_budget` number, nullable
    - `budget_duration` string, nullable
    - `budget_limits` BudgetLimitEntry[], nullable
      - `budget_duration` string, required
      - `max_budget` number, required
      - `reset_at` string, date-time, nullable
    - `models` unknown[]
      - unknown
    - `blocked` boolean
    - `router_settings` object, nullable
    - `access_group_ids` string[], nullable
    - `default_team_member_models` string[], nullable
    - `spend` number, nullable
    - `max_parallel_requests` integer, nullable
    - `budget_reset_at` string, date-time, nullable
    - `model_id` integer, nullable
    - `litellm_model_table` LiteLLMModelTable
      - `id` integer, nullable
      - `model_aliases` union
        - object
        - string
      - `created_by` string, required
      - `updated_by` string, required
      - `team` LiteLLMTeamTable — recursive
    - `object_permission` LiteLLMObjectPermissionTable — Represents a LiteLLM_ObjectPermissionTable record
      - `object_permission_id` string, required
      - `mcp_servers` string[], nullable
      - `mcp_access_groups` string[], nullable
      - `mcp_tool_permissions` object, nullable
      - `vector_stores` string[], nullable
      - `agents` string[], nullable
      - `agent_access_groups` string[], nullable
      - `mcp_toolsets` string[], nullable
      - `blocked_tools` string[], nullable
      - `search_tools` string[], nullable
    - `updated_at` string, date-time, nullable
    - `created_at` string, date-time, nullable
    - `object_permission_id` string, nullable
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422` — Validation Error

---

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