# List all tenants within an omnibus structure

Endpoint: GET /v1/domains/{domainId}/omnibus/{omnibusId}/tenants

## Path parameters:

  - `domainId` (string, required)

  - `omnibusId` (string, required)

## Query parameters:

  - `page` (integer)

  - `size` (integer)

  - `search` (string)
    Case-insensitive substring match on tenant alias. Terms shorter than 3 characters return an empty page (the trigram index cannot serve them).

  - `status` (string)
    Filter tenants by status. Absent means no status filtering.
    Enum: "LOCKED", "UNLOCKED"

## Response 200 fields (application/json):

  - `content` (array, required)

  - `content.id` (string, required)
    Unique identifier of the tenant

  - `content.omnibusId` (string, required)
    Identifier of the omnibus structure this tenant belongs to

  - `content.alias` (string, required)
    Alias of the tenant

  - `content.isHost` (boolean, required)
    Whether this tenant is the host tenant of the omnibus structure. This field is immutable and set at creation time.

  - `content.status` (string, required)
    Enum: "LOCKED", "UNLOCKED"

  - `content.createdAt` (string, required)
    Timestamp when the tenant was created

  - `content.updatedAt` (string, required)
    Timestamp when the tenant was last updated

  - `content.balances` (array)
    Balances per ticker/ledger combination

  - `content.balances.tickerId` (string, required)
    Ticker identifier

  - `content.balances.ledgerId` (string, required)
    Ledger identifier

  - `content.balances.reserved` (string, required)
    Reserved amount

  - `content.balances.quarantined` (string, required)
    Quarantined amount

  - `content.balances.availableBalance` (string)
    Available balance from accounting service; absent if the accounting service is unavailable

  - `content.description` (string)
    Description of the tenant

  - `content.customProperties` (array)
    Custom key-value properties

  - `content.customProperties.key` (string, required)
    Property key

  - `content.customProperties.value` (string, required)
    Property value

  - `page` (object, required)
    Pagination metadata for tenant listings. Unlike the shared PageMetadata, totalElements/totalPages are optional: the alias-search path uses a cursor-style (Slice) query that does not compute totals, while the full-list path still populates them.

  - `page.number` (integer, required)
    Current page number (0-indexed)

  - `page.size` (integer, required)
    Number of elements per page

  - `page.totalElements` (integer)
    Total number of elements across all pages. Absent for cursor-style (Slice) responses such as alias search, where totals are not computed.

  - `page.totalPages` (integer)
    Total number of pages. Absent for cursor-style (Slice) responses such as alias search, where totals are not computed.

  - `page.first` (boolean, required)
    Whether this is the first page

  - `page.last` (boolean, required)
    Whether this is the last page