## 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: Array[{ id, idp_org_id, idp_provider, 3 more}]`

    - `id: String`

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

    - `idp_org_id: String`

      IdP-issued tenant id (WorkOS org id).

    - `idp_provider: :workos | :vitable`

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

      - `:workos`

      - `:vitable`

    - `name: String`

      Human-readable organization name.

    - `super_in: bool`

      Whether this organization reads across every organization.

    - `type: :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: Integer`

    Total number of organizations the caller belongs to.

### Example

```ruby
require "vitable_connect"

vitable_connect = VitableConnect::Client.new(
  environment: "environment_1" # defaults to "production"
)

organizations = vitable_connect.organizations.list

puts(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
}
```