Skip to main content
You can list Box Hubs in two ways: 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)

ParameterTypeRequiredDescription
querystringNoSearch string for Box Hubs.
scopestringNoeditable, view_only, or all. Default is all.
sortstringNoSort by name, updated_at, last_accessed_at, view_count, or relevance. Default is relevance.
directionstringNoASC or DESC.
markerstringNoMarker for marker-based pagination.
limitintegerNoMaximum 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.
Last modified on April 23, 2026