## List my organizations

`organizations.list()  -> OrganizationListResponse`

**get** `/v1/organizations`

Lists the organizations the authenticated caller is an active member of (paginated). Returns an empty list when the caller belongs to no organizations.

### Returns

- `class OrganizationListResponse: …`

  Envelope for the caller's organization memberships (paginated).

  - `organizations: List[Organization]`

    - `id: str`

      Prefixed organization identifier (`org_<base64-encoded-uuid>`).

    - `idp_org_id: Optional[str]`

      IdP-issued tenant id (WorkOS org id).

    - `idp_provider: Optional[Literal["workos", "vitable"]]`

      * `workos` - WorkOS
      * `vitable` - Vitable

      - `"workos"`

      - `"vitable"`

    - `name: str`

      Human-readable organization name.

    - `super_in: bool`

      Whether this organization reads across every organization.

    - `type: Optional[Literal["BROKERAGE", "TPA", "GENERAL_AGENT", 3 more]]`

      * `BROKERAGE` - Brokerage
      * `TPA` - TPA
      * `GENERAL_AGENT` - General Agent
      * `CHANNEL_PARTNER` - Channel Partner
      * `CONSULTING_FIRM` - Consulting Firm
      * `API_PLATFORM` - API Platform

      - `"BROKERAGE"`

      - `"TPA"`

      - `"GENERAL_AGENT"`

      - `"CHANNEL_PARTNER"`

      - `"CONSULTING_FIRM"`

      - `"API_PLATFORM"`

  - `total: int`

    Total number of organizations the caller belongs to.

### Example

```python
from vitable_connect import VitableConnect

client = VitableConnect()
organizations = client.organizations.list()
print(organizations.organizations)
```

#### Response

```json
{
  "organizations": [
    {
      "id": "org_abc123def456",
      "name": "Acme Brokerage",
      "type": "BROKERAGE",
      "idp_org_id": "org_01J0WORKOS",
      "idp_provider": "workos",
      "super_in": false
    }
  ],
  "total": 1
}
```