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.

List hubs for the requesting user

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

Box CLI

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 CLI

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.