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 GET /2.0/hubs endpoint. 
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"

​
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 Global Content Manager (GCM) scope can list all Box Hubs for the enterprise using the GET /2.0/enterprise_hubs endpoint. 
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"
Both endpoints return a list of hubs with pagination fields (limit, next_marker). Use the API reference for full parameter descriptions and limitations.