household.list
Overview
- Returns households with member counts and residence info. Defaults to residential families only (bCanMoveIn=true and a residence site is connected). Pass include=all to include game-internal NPC households and households without a residence site.
Metadata
| Field | Value |
|---|---|
| Display | List Households |
| Category | household |
| Access | Public |
| Scope | B2Authority |
| Tags | — |
| Aliases | — |
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
| limit | int | no | — | Max households to return (default: 50) |
| offset | int | no | — | Skip first N households (default: 0) |
| include | string | no | — | Filter: residential (default, bCanMoveIn=true and residence site connected) or all |
Returns
Returns a JSON object with the following fields:
| Field | Type | Required | Description |
|---|---|---|---|
total | int | yes | Total households matched |
offset | int | yes | Pagination offset |
limit | int | yes | Pagination limit |
include | string | yes | Filter applied (residential/all) |
households | array | yes | Households |
households[].household_id | entityId | yes | Household entity id |
households[].name | string | yes | Household display name |
households[].member_count | int | yes | Number of members |
households[].residence_site_id | entityId | yes | Residence site entity id |
households[].residence_site_name | string | yes | Residence site name |
households[].can_move_in | bool | yes | Whether the household can move in |
households[].ever_possessed | bool | yes | Whether ever possessed |
Usage
await inzoi.cli.execute('household.list', {
limit: 0, // optional
offset: 0, // optional
include: '', // optional
});