List active hubs

Returns a paginated list of all active hubs, optionally filtered by hub ID and sorted by a chosen column.

View as Markdown

Prerequisites

Authentication and setup: A valid access token.

Endpoint

POST /api/assethub/v1/hubs

Base URL: the API3 REST host for your region. See Base URLs.

Headers: Authorization: Bearer ACCESS_TOKEN, Content-Type: application/json.

Request

Parameter	Type	Required	Description
`hub_ids`	string[]	Optional	List of hub IDs to filter by. Any array of `hub_id` strings.
`skip`	int32	Optional	Number of hubs to skip for pagination. Must be 0 or more.
`limit`	int32	Optional	Maximum number of hubs to return for pagination. Must be from 1 to 100. Default: 100.
`order_by.field`	string	Required if `order_by` is used	Column to order by. One of `title`, `updated_at`, `created_at`, `created_by`, `hub_type`, `hub_id`.
`order_by.order`	string	Required if `order_by` is used	Sort direction. `ASC` or `DESC`.

Request example

{
  "skip": 0,
  "limit": 2
}

Response

Field	Type	Description
`total_hubs_count`	int	Total number of hubs.
`hub_details[].id`	string	Hub unique identifier.
`hub_details[].title`	string	Hub name.
`hub_details[].description`	string	Hub description. Present only if the hub has a description.
`hub_details[].last_updated_at`	string	Epoch in seconds.

Response example

{
  "total_hubs_count": 312,
  "hub_details": [
    {
      "id": "123456789012345101",
      "title": "134123",
      "last_updated_at": "1751011672"
    },
    {
      "id": "123456789012345102",
      "title": "312",
      "last_updated_at": "1751011668"
    }
  ]
}

Notes

Validation: field and order are both required if order_by is used.
Behavior: Invalid hub_ids are silently ignored. No error is returned.
Behavior: If skip results in an empty page, the hub_details key may be missing entirely.