List hubs

You can list Box Hubs in two ways:

All hubs for the requesting user
All 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.

List hubs for the requesting user

To retrieve all Box Hubs accessible to the authenticated user, call the endpoint.

box hubs --scope all --sort name --direction ASC

curl -i -X GET "https://api.box.com/2.0/hubs?scope=all&sort=name&direction=ASC" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "box-version: 2025.0"

await client.hubs.getHubsV2025R0({
  scope: 'all',
  sort: 'name',
  direction: 'ASC' as GetHubsV2025R0QueryParamsDirectionField,
} satisfies GetHubsV2025R0QueryParams);

client.hubs.get_hubs_v2025_r0(scope="all", sort="name", direction=GetHubsV2025R0Direction.ASC)

await client.Hubs.GetHubsV2025R0Async(queryParams: new GetHubsV2025R0QueryParams() { Scope = "all", Sort = "name", Direction = GetHubsV2025R0QueryParamsDirectionField.Asc });

try await client.hubs.getHubsV2025R0(queryParams: GetHubsV2025R0QueryParams(scope: "all", sort: "name", direction: GetHubsV2025R0QueryParamsDirectionField.asc))

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 scope can list all Box Hubs for the enterprise using the endpoint.

box hubs:enterprise --sort name --direction ASC

curl -i -X GET "https://api.box.com/2.0/enterprise_hubs?scope=all&sort=name&direction=ASC" \
     -H "Authorization: Bearer <ACCESS_TOKEN>" \
     -H "box-version: 2025.0"

await client.hubs.getEnterpriseHubsV2025R0({
  scope: 'all',
  sort: 'name',
  direction: 'ASC' as GetEnterpriseHubsV2025R0QueryParamsDirectionField,
} satisfies GetEnterpriseHubsV2025R0QueryParams);

client.hubs.get_enterprise_hubs_v2025_r0(scope="all", sort="name", direction=GetEnterpriseHubsV2025R0Direction.ASC)

await client.Hubs.GetEnterpriseHubsV2025R0Async(queryParams: new GetEnterpriseHubsV2025R0QueryParams() { Scope = "all", Sort = "name", Direction = GetEnterpriseHubsV2025R0QueryParamsDirectionField.Asc });

try await client.hubs.getEnterpriseHubsV2025R0(queryParams: GetEnterpriseHubsV2025R0QueryParams(scope: "all", sort: "name", direction: GetEnterpriseHubsV2025R0QueryParamsDirectionField.asc))

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.

Getting started

Applications & integrations

Identity & access

Using the API

Troubleshooting

Content

Collaboration

Metadata & search

Events & webhooks

Users

Intelligent workflow

E-signatures

Security & compliance

List hubs for the requesting user

Query parameters (list hubs for user)

List hubs for the enterprise

​List hubs for the requesting user

​Query parameters (list hubs for user)

​List hubs for the enterprise

List hubs for the requesting user

Query parameters (list hubs for user)

List hubs for the enterprise