# List spaces

URL: https://docs.hanzo.ai/docs/openapi/space/get-space-spaces

> Lists the caller org's own spaces.

`GET /v1/space/spaces`

> [Space →](https://docs.hanzo.ai/docs/openapi/space) · [All API references →](https://docs.hanzo.ai/docs/openapi) · [Get started →](https://docs.hanzo.ai/docs/guides)

|               |                                        |
| ------------- | -------------------------------------- |
| **Address**   | `https://api.hanzo.ai/v1/space/spaces` |
| **Method**    | `GET`                                  |
| **Operation** | `get_space_spaces`                     |
| **Auth**      | `Authorization: Bearer $HANZO_API_KEY` |

Lists the caller org's own spaces.

Only the caller's: every space is physically named under a per-org prefix and
the listing strips that prefix, so another org's spaces are not in the answer at
all. Another org's space is not refused but INVISIBLE, so this cannot be used to
learn that a name is taken elsewhere.

Billed per call: the balance is checked BEFORE anything is touched, so an
unfunded org is refused with nothing done, and the debit lands only once the
work has succeeded.

## Request

`GET /v1/space/spaces` takes no parameters and no body — the credential is the whole request.

## Response

| Status    | Body            | Meaning |
| --------- | --------------- | ------- |
| `200`     | space.spaceList | ok      |
| `default` | problem-details | refused |

`200` body — 4 fields.

| Field                | In   | Type               | Always | Description                                                                 |
| -------------------- | ---- | ------------------ | ------ | --------------------------------------------------------------------------- |
| `spaces`             | body | space.spaceItem\[] | —      | Spaces are the caller org's spaces, oldest first as the store returns them. |
| `spaces[].createdAt` | body | integer (int64)    | —      | CreatedAt is when the space was made, in unix seconds.                      |
| `spaces[].name`      | body | string             | —      | Name is the space's name, as the org created it.                            |
| `total`              | body | integer (int64)    | —      | Total is how many spaces this org has.                                      |

Failure carries the platform error shape — see [Errors](https://docs.hanzo.ai/docs/errors).

## Examples

**CLI**

```bash
hanzo space spaces get
```

**SDK**

**.ts**

```ts
import { Configuration, SpaceApi } from 'hanzoai';

const api = new SpaceApi(new Configuration({ accessToken: process.env.HANZO_API_KEY }));
const { data } = await api.getSpaceSpaces();
```

**.py**

```python
from hanzoai.cloud import ApiClient, Configuration
from hanzoai.cloud.api import SpaceApi

client = ApiClient(Configuration(access_token=os.environ["HANZO_API_KEY"]))
result = SpaceApi(client).get_space_spaces()
```

**.go**

```go
cfg := hanzoai.NewConfiguration()
cfg.AddDefaultHeader("Authorization", "Bearer "+os.Getenv("HANZO_API_KEY"))
client := hanzoai.NewAPIClient(cfg)

resp, _, err := client.SpaceAPI.GetSpaceSpaces(context.Background()).Execute()
if err != nil {
	return err
}
```

**.rs**

```rust
use hanzo_client::apis::{configuration::Configuration, space_api};

let mut cfg = Configuration::new();
cfg.bearer_access_token = std::env::var("HANZO_API_KEY").ok();

let result = space_api::get_space_spaces(&cfg, Default::default()).await?;
```

**.java**

```java
import ai.hanzo.cloud.ApiClient;
import ai.hanzo.cloud.api.SpaceApi;

ApiClient client = new ApiClient();
client.setBearerToken(System.getenv("HANZO_API_KEY"));

var result = new SpaceApi(client).getSpaceSpaces();
```

**HTTP**

```bash
curl https://api.hanzo.ai/v1/space/spaces \
  -H "Authorization: Bearer $HANZO_API_KEY"
```

**MCP**

MCP reaches **space** through the `space` tool, which names its 7 operations with its own verbs — this one among them, under a name only MCP declares. `describe` explains any of them:

```bash
curl -X POST https://api.hanzo.ai/v1/mcp \
  -H "Content-Type: application/json" \
  -d '{
       "jsonrpc": "2.0",
       "id": 1,
       "method": "tools/call",
       "params": {
         "name": "describe",
         "arguments": {
           "op": "list_space_drives"
         }
       }
     }'
```

---

[Space API](https://docs.hanzo.ai/docs/openapi/space) · [All Hanzo APIs](https://docs.hanzo.ai/docs/openapi) · [Interactive reference](https://docs.hanzo.ai/docs/openapi/reference)