Capacity groups

Groups that can occupy units, such as adults, children or pets. Useful for separate prices and limits per group

Endpoints

GET/capacity_groupsPOST/capacity_groupsDELETE/capacity_groupsPATCH/capacity_groups

The capacity group object

Attributes

iduuid

Unique identifier

organization_iduuid

organizations.id

Identifier of the organization this capacity group is defined in

created_atread-onlytimestamp with time zone

Creation timestamp

updated_atread-onlytimestamp with time zone

Last modification timestamp

descriptionMultiLanguageString

Localized description of the capacity group

nameMultiLanguageString

Localized name of the capacity group

name_singularMultiLanguageString

Localized singular name of the capacity group

orderinteger

Order of the capacity group as displayed on widgets and websites

requires_explicit_inputboolean

Whether guests need to explicitly fill in the capacity before booking

typeCapacityGroupType

Type of the capacity group

Related resources

Embed related resources in the response with the select parameter, for example select=*,organizations(*). Resources related through more than one column need the column as a hint, like table!column(*).

organizations(*)object | null

organizations

The organization referenced by organization_id.

capacities(*)array

capacities

The capacities referencing this capacity group through capacities.capacity_group_id.

capacity_group_dependencies!accumulator_id(*)array

capacity_group_dependencies

The capacity group dependencies referencing this capacity group through capacity_group_dependencies.accumulator_id.

capacity_group_dependencies!element_id(*)array

capacity_group_dependencies

The capacity group dependencies referencing this capacity group through capacity_group_dependencies.element_id.

The capacity group object

JSON

{
  "id": "00000000-0000-0000-0000-000000000000",
  "organization_id": "00000000-0000-0000-0000-000000000000",
  "created_at": "2026-10-30T22:27:57.051Z",
  "updated_at": "2026-10-30T22:27:57.051Z",
  "description": {},
  "name": {},
  "name_singular": {},
  "order": 1,
  "requires_explicit_input": false,
  "type": "manual"
}

Including related resources

curl -X GET "https://api.bookingmood.com/v1/capacity_groups?limit=10&select=*,organizations(*),capacities(*)" \
  -H "Authorization: Bearer YOUR_API_KEY"

List capacity groups

Filters

idFilter<uuid>

Unique identifier

organization_idFilter<uuid>

organizations.id

Identifier of the organization this capacity group is defined in

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

descriptionFilter<MultiLanguageString>

Localized description of the capacity group

nameFilter<MultiLanguageString>

Localized name of the capacity group

name_singularFilter<MultiLanguageString>

Localized singular name of the capacity group

orderFilter<integer>

Order of the capacity group as displayed on widgets and websites

requires_explicit_inputFilter<boolean>

Whether guests need to explicitly fill in the capacity before booking

typeFilter<CapacityGroupType>

Type of the capacity group

Responses

200

A list of capacity groups with the selected columns

206

Partial Content

400

The request is malformed, for example an unknown column or an invalid filter.

401

The API key is missing or invalid.

Error responses have a JSON body with a code, message, details and hint. See the introduction for more on errors.

GET /capacity_groups

curl -X GET "https://api.bookingmood.com/v1/capacity_groups?select=*&limit=10" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response

JSON

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "organization_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2026-10-30T22:27:57.051Z",
    "updated_at": "2026-10-30T22:27:57.051Z",
    "description": {},
    "name": {},
    "name_singular": {},
    "order": 1,
    "requires_explicit_input": false,
    "type": "manual"
  }
]

Create capacity groups

Body

Partial<CapacityGroup> | Array<Partial<CapacityGroup>>

Read-only attributes are set by the database and can't be written.

Responses

201

The newly created capacity groups with the selected columns

400

The request is malformed, for example an unknown column, an invalid filter or an invalid body.

401

The API key is missing or invalid.

403

The API key has no permission for this change, for example when writing rows of another organization.

409

The change conflicts with existing data, for example a duplicate key or a reference to a row that does not exist.

Error responses have a JSON body with a code, message, details and hint. See the introduction for more on errors.

POST /capacity_groups

curl -X POST "https://api.bookingmood.com/v1/capacity_groups" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": {},
    "name": {},
    "name_singular": {},
    "order": 1,
    "organization_id": "00000000-0000-0000-0000-000000000000",
    "requires_explicit_input": false,
    "type": "manual"
  }'

Example response

JSON

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "organization_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2026-10-30T22:27:57.051Z",
    "updated_at": "2026-10-30T22:27:57.051Z",
    "description": {},
    "name": {},
    "name_singular": {},
    "order": 1,
    "requires_explicit_input": false,
    "type": "manual"
  }
]

Delete capacity groups

Filters

Without filters, this request deletes all capacity groups you have access to. Always filter on at least one column, e.g. id=eq.{id}.

idFilter<uuid>

Unique identifier

organization_idFilter<uuid>

organizations.id

Identifier of the organization this capacity group is defined in

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

descriptionFilter<MultiLanguageString>

Localized description of the capacity group

nameFilter<MultiLanguageString>

Localized name of the capacity group

name_singularFilter<MultiLanguageString>

Localized singular name of the capacity group

orderFilter<integer>

Order of the capacity group as displayed on widgets and websites

requires_explicit_inputFilter<boolean>

Whether guests need to explicitly fill in the capacity before booking

typeFilter<CapacityGroupType>

Type of the capacity group

Responses

200

The deleted capacity groups with the selected columns. Returns 204 without a body when sending the header Prefer: return=minimal.

400

The request is malformed, for example an unknown column or an invalid filter.

401

The API key is missing or invalid.

403

The API key has no permission for this change, for example when writing rows of another organization.

Error responses have a JSON body with a code, message, details and hint. See the introduction for more on errors.

DELETE /capacity_groups

curl -X DELETE "https://api.bookingmood.com/v1/capacity_groups?id=eq.00000000-0000-0000-0000-000000000000" \
  -H "Authorization: Bearer YOUR_API_KEY"

Example response

JSON

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "organization_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2026-10-30T22:27:57.051Z",
    "updated_at": "2026-10-30T22:27:57.051Z",
    "description": {},
    "name": {},
    "name_singular": {},
    "order": 1,
    "requires_explicit_input": false,
    "type": "manual"
  }
]

Update capacity groups

Filters

Without filters, this request updates all capacity groups you have access to. Always filter on at least one column, e.g. id=eq.{id}.

idFilter<uuid>

Unique identifier

organization_idFilter<uuid>

organizations.id

Identifier of the organization this capacity group is defined in

created_atFilter<timestamp with time zone>

Creation timestamp

updated_atFilter<timestamp with time zone>

Last modification timestamp

descriptionFilter<MultiLanguageString>

Localized description of the capacity group

nameFilter<MultiLanguageString>

Localized name of the capacity group

name_singularFilter<MultiLanguageString>

Localized singular name of the capacity group

orderFilter<integer>

Order of the capacity group as displayed on widgets and websites

requires_explicit_inputFilter<boolean>

Whether guests need to explicitly fill in the capacity before booking

typeFilter<CapacityGroupType>

Type of the capacity group

Body

Partial<CapacityGroup>

Read-only attributes are set by the database and can't be written.

Responses

200

The updated capacity groups with the selected columns. Returns 204 without a body when sending the header Prefer: return=minimal.

400

The request is malformed, for example an unknown column, an invalid filter or an invalid body.

401

The API key is missing or invalid.

403

The API key has no permission for this change, for example when writing rows of another organization.

409

The change conflicts with existing data, for example a duplicate key or a reference to a row that does not exist.

Error responses have a JSON body with a code, message, details and hint. See the introduction for more on errors.

PATCH /capacity_groups

curl -X PATCH "https://api.bookingmood.com/v1/capacity_groups?id=eq.00000000-0000-0000-0000-000000000000" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": {}
  }'

Example response

JSON

[
  {
    "id": "00000000-0000-0000-0000-000000000000",
    "organization_id": "00000000-0000-0000-0000-000000000000",
    "created_at": "2026-10-30T22:27:57.051Z",
    "updated_at": "2026-10-30T22:27:57.051Z",
    "description": {},
    "name": {},
    "name_singular": {},
    "order": 1,
    "requires_explicit_input": false,
    "type": "manual"
  }
]

Capacity groups

The capacity group object

Attributes

Related resources

List capacity groups

Filters

Responses

Create capacity groups

Body

Responses

Delete capacity groups

Filters

Responses

Update capacity groups

Filters

Body

Responses

Take control of your bookings. Build a business you own.