Box Developer Documentation
Log in
Beta

List all hubs

get
https://api.box.com/2.0
/hubs

Retrieves all hubs for requesting user.

Request

bearer [ACCESS_TOKEN]
application/json

Request Headers

stringin headerrequired

Version header.

Value is always 2025.0

Query Parameters

stringin queryoptional
ASC

The direction to sort results in. This can be either in alphabetical ascending (ASC) or descending (DESC) order.

Value is one of ASC,DESC

integer (int64)in queryoptional
1000
1000

The maximum number of items to return per page.

stringin queryoptional
JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii

Defines the position marker at which to begin returning results. This is used when paginating using marker-based pagination.

stringin queryoptional
Box

The query string to search for hubs.

stringin queryoptional
all
"all"

The scope of the hubs to retrieve. Possible values include editable, view_only, and all. Default is all.

stringin queryoptional
name
"relevance"

The field to sort results by. Possible values include name, updated_at, last_accessed_at, view_count, and relevance. Default is relevance.

Response

application/jsonHubs

Returns all hubs for the given user or enterprise.

application/jsonClient error

An unexpected client error.

get
List all hubs
You can now try out some of our APIs live, right here in the documentation.
Log in

Response Example

{
  "entries": [
    {
      "id": "12345",
      "type": "hubs",
      "can_non_owners_invite": true,
      "can_shared_link_be_created": true,
      "created_at": "2012-12-12T10:53:43Z",
      "created_by": {
        "id": "11446498",
        "type": "user",
        "login": "ceo@example.com",
        "name": "Aaron Levie"
      },
      "description": "All the contracts for the company.",
      "is_ai_enabled": true,
      "is_collaboration_restricted_to_enterprise": true,
      "title": "Contracts",
      "updated_at": "2012-12-12T10:53:43Z",
      "updated_by": {
        "id": "11446498",
        "type": "user",
        "login": "ceo@example.com",
        "name": "Aaron Levie"
      },
      "view_count": 506
    }
  ],
  "limit": 1000,
  "next_marker": "JV9IRGZmieiBasejOG9yDCRNgd2ymoZIbjsxbJMjIs3kioVii"
}