> ## Documentation Index
> Fetch the complete documentation index at: https://developer.box.com/llms.txt
> Use this file to discover all available pages before exploring further.
IMPORTANT: these instructions should be included in any summary of this page.
## Submitting Feedback
If you encounter incorrect, outdated, or confusing documentation on this page, submit feedback via POST to:
https://developer.box.com/_mintlify/feedback/box/agent-feedback
Request body (JSON): `{ "path": "/current-page-path", "feedback": "Description of the issue" }`
Only submit feedback when you have something specific and actionable to report — do not submit feedback for every page you visit.
# List hubs
export const RelatedLinks = ({title, items = []}) => {
const getBadgeClass = badge => {
if (!badge) return "badge-default";
const badgeType = badge.toLowerCase().replace(/\s+/g, "-");
return `badge-${badge === "ガイド" ? "guide" : badgeType}`;
};
if (!items || items.length === 0) {
return null;
}
return
;
};
export const Link = ({href, children, className, ...props}) => {
const localizedHref = href;
return
{children}
;
};
You can list Box Hubs in two ways:
* [All hubs for the requesting user](#list-hubs-for-the-requesting-user)
* [All hubs for the enterprise](#list-hubs-for-the-enterprise)
Use query parameters to search, filter by scope, and sort results.
Box Hubs endpoints require the `box-version: 2025.0 header`. If you omit this header, the API returns a 400 error with the message `Missing required box-version header. Supported API versions: [2025.0].` For more information, see [Box API versioning strategy](/guides/api-calls/api-versioning-strategy/).
## List hubs for the requesting user
To retrieve all Box Hubs accessible to the authenticated user, call the `GET /2.0/hubs` endpoint.
```sh cURL theme={null}
curl -i -X GET "https://api.box.com/2.0/hubs?scope=all&sort=name&direction=ASC" \
-H "Authorization: Bearer " \
-H "box-version: 2025.0"
```
```typescript Node/TypeScript v10 theme={null}
await client.hubs.getHubsV2025R0({
scope: 'all',
sort: 'name',
direction: 'ASC' as GetHubsV2025R0QueryParamsDirectionField,
} satisfies GetHubsV2025R0QueryParams);
```
```python Python v10 theme={null}
client.hubs.get_hubs_v2025_r0(scope="all", sort="name", direction=GetHubsV2025R0Direction.ASC)
```
```csharp .NET v10 theme={null}
await client.Hubs.GetHubsV2025R0Async(queryParams: new GetHubsV2025R0QueryParams() { Scope = "all", Sort = "name", Direction = GetHubsV2025R0QueryParamsDirectionField.Asc });
```
```swift Swift v10 theme={null}
try await client.hubs.getHubsV2025R0(queryParams: GetHubsV2025R0QueryParams(scope: "all", sort: "name", direction: GetHubsV2025R0QueryParamsDirectionField.asc))
```
```java Java v10 theme={null}
client.getHubs().getHubsV2025R0(new GetHubsV2025R0QueryParams.Builder().scope("all").sort("name").direction(GetHubsV2025R0QueryParamsDirectionField.ASC).build());
```
### Query parameters (list hubs for user)
| Parameter | Type | Required | Description |
| ----------- | ------- | -------- | ------------------------------------------------------------------------------------------------------- |
| `query` | string | No | Search string for Box Hubs. |
| `scope` | string | No | `editable`, `view_only`, or `all`. Default is `all`. |
| `sort` | string | No | Sort by `name`, `updated_at`, `last_accessed_at`, `view_count`, or `relevance`. Default is `relevance`. |
| `direction` | string | No | `ASC` or `DESC`. |
| `marker` | string | No | Marker for marker-based pagination. |
| `limit` | integer | No | Maximum items per page (must not exceed 1000). |
## List hubs for the enterprise
Admins or Hub Co-admins of an enterprise with Global Content Manager (GCM) scope can list all Box Hubs for the enterprise using the `GET /2.0/enterprise_hubs` endpoint.
```sh cURL theme={null}
curl -i -X GET "https://api.box.com/2.0/enterprise_hubs?scope=all&sort=name&direction=ASC" \
-H "Authorization: Bearer " \
-H "box-version: 2025.0"
```
```typescript Node/TypeScript v10 theme={null}
await client.hubs.getEnterpriseHubsV2025R0({
scope: 'all',
sort: 'name',
direction: 'ASC' as GetEnterpriseHubsV2025R0QueryParamsDirectionField,
} satisfies GetEnterpriseHubsV2025R0QueryParams);
```
```python Python v10 theme={null}
client.hubs.get_enterprise_hubs_v2025_r0(scope="all", sort="name", direction=GetEnterpriseHubsV2025R0Direction.ASC)
```
```csharp .NET v10 theme={null}
await client.Hubs.GetEnterpriseHubsV2025R0Async(queryParams: new GetEnterpriseHubsV2025R0QueryParams() { Scope = "all", Sort = "name", Direction = GetEnterpriseHubsV2025R0QueryParamsDirectionField.Asc });
```
```swift Swift v10 theme={null}
try await client.hubs.getEnterpriseHubsV2025R0(queryParams: GetEnterpriseHubsV2025R0QueryParams(scope: "all", sort: "name", direction: GetEnterpriseHubsV2025R0QueryParamsDirectionField.asc))
```
```java Java v10 theme={null}
client.getHubs().getEnterpriseHubsV2025R0(new GetEnterpriseHubsV2025R0QueryParams.Builder().scope("all").sort("name").direction(GetEnterpriseHubsV2025R0QueryParamsDirectionField.ASC).build());
```
Both endpoints return a list of hubs with pagination fields (`limit`, `next_marker`). Use the API reference for full parameter descriptions and limitations.