# Orgs

## List organizations

`orgs.list()  -> OrgListResponse`

**get** `/v0/orgs`

List organizations accessible to the current authentication method.

### Returns

- `class OrgListResponse: …`

  - `data: List[Org]`

    - `display_name: Optional[str]`

    - `enable_ai_commit_messages: bool`

    - `object: Literal["org"]`

      - `"org"`

    - `slug: str`

  - `has_more: bool`

  - `next_cursor: Optional[str]`

### Example

```python
import os
from stainless_v0 import Stainless

client = Stainless(
    api_key=os.environ.get("STAINLESS_API_KEY"),  # This is the default and can be omitted
)
orgs = client.orgs.list()
print(orgs.data)
```

#### Response

```json
{
  "data": [
    {
      "display_name": "display_name",
      "enable_ai_commit_messages": true,
      "object": "org",
      "slug": "slug"
    }
  ],
  "has_more": true,
  "next_cursor": "next_cursor"
}
```

## Retrieve an organization

`orgs.retrieve(strorg)  -> Org`

**get** `/v0/orgs/{org}`

Retrieve an organization by name.

### Parameters

- `org: str`

### Returns

- `class Org: …`

  - `display_name: Optional[str]`

  - `enable_ai_commit_messages: bool`

  - `object: Literal["org"]`

    - `"org"`

  - `slug: str`

### Example

```python
import os
from stainless_v0 import Stainless

client = Stainless(
    api_key=os.environ.get("STAINLESS_API_KEY"),  # This is the default and can be omitted
)
org = client.orgs.retrieve(
    "org",
)
print(org.display_name)
```

#### Response

```json
{
  "display_name": "display_name",
  "enable_ai_commit_messages": true,
  "object": "org",
  "slug": "slug"
}
```

## Domain Types

### Org

- `class Org: …`

  - `display_name: Optional[str]`

  - `enable_ai_commit_messages: bool`

  - `object: Literal["org"]`

    - `"org"`

  - `slug: str`

### Org List Response

- `class OrgListResponse: …`

  - `data: List[Org]`

    - `display_name: Optional[str]`

    - `enable_ai_commit_messages: bool`

    - `object: Literal["org"]`

      - `"org"`

    - `slug: str`

  - `has_more: bool`

  - `next_cursor: Optional[str]`