/v1/unit-groups/{unit_group_id}Authentication
Bearer API key or Facily session, subject to permissions and facility scope.
Authentication and scopeRequest example
Replace bracketed path values with real IDs from your environment. The body, where shown, is generated from the schema and uses illustrative values.
curl --request GET \
--url 'https://api.staging.facily.ai/v1/unit-groups/<UNIT_GROUP_ID>' \
--header "Authorization: Bearer $FACILY_API_KEY"Try a request
Staging · read-onlyExplore your organization with a read-only request to staging.
Parameters
unit_group_idpath · stringrequiredFormat: uuid
Responses
Expand a status to inspect its schema. Generated examples show structure and synthetic values.
200Successful Response
{
"data": {
"created_at": "2026-10-29T12:00:00Z",
"facility_id": "00000000-0000-4000-8000-000000000001",
"id": "00000000-0000-4000-8000-000000000001",
"name": "string",
"updated_at": "2026-10-29T12:00:00Z",
"active_rules": [
{
"id": "00000000-0000-4000-8000-000000000001",
"name": "string"
}
],
"code": "string",
"description": "string",
"effective_standard_rate": "<VALUE_MATCHING_PATTERN>",
"effective_web_rate": "<VALUE_MATCHING_PATTERN>",
"feature_ids": [
"00000000-0000-4000-8000-000000000001"
],
"feature_names": [
"string"
]
},
"meta": {
"request_id": "string"
}
}application/json
dataUnitGroupDetailResponserequiredOne group with what the group list row says about it and every member unit.
Show data schema
active_rulesActiveRuleRef[]Pricing rules applying to this group now.
Show active_rules schema
idstringrequiredFormat: uuid
namestringrequiredcodestring | nullShort operator-assigned code for the group.
Show code schema
string | nullShort operator-assigned code for the group.
Variant 1: string
stringVariant 2: null
nullcreated_atstringrequiredWhen the group was created.
Format: date-time
descriptionstring | nullLonger description of what the group covers.
Show description schema
string | nullLonger description of what the group covers.
Variant 1: string
stringVariant 2: null
nulleffective_standard_ratestring | nullThe street rate a unit of this group quotes when it has no rate of its own.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show effective_standard_rate schema
string | nullThe street rate a unit of this group quotes when it has no rate of its own.
Variant 1: string
stringVariant 2: null
nulleffective_web_ratestring | nullThe online rate a unit of this group quotes when it has no rate of its own.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show effective_web_rate schema
string | nullThe online rate a unit of this group quotes when it has no rate of its own.
Variant 1: string
stringVariant 2: null
nullfacility_idstringrequiredThe facility this group belongs to.
Format: uuid
feature_idsstring[]The group's characteristics.
Show feature_ids schema
stringfeature_namesstring[]Names of the group's characteristics.
Show feature_names schema
stringfloorinteger | nullFloor the group's units are on, when it has one.
Show floor schema
integer | nullFloor the group's units are on, when it has one.
Variant 1: integer
integerVariant 2: null
nullidstringrequiredUnique identifier for this unit group.
Format: uuid
managedbooleanTrue when pricing rules set the effective street rate.
Default: false
managed_ratestring | nullStreet rate set by pricing rules; null when none applies.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show managed_rate schema
string | nullStreet rate set by pricing rules; null when none applies.
Variant 1: string
stringVariant 2: null
nullmanaged_web_discountstring | nullPercentage points pricing rules add to the online discount; null when none applies.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show managed_web_discount schema
string | nullPercentage points pricing rules add to the online discount; null when none applies.
Variant 1: string
stringVariant 2: null
nullmax_ratestring | nullCeiling: no pricing rule moves the street rate above it.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show max_rate schema
string | nullCeiling: no pricing rule moves the street rate above it.
Variant 1: string
stringVariant 2: null
nullmin_ratestring | nullFloor: no pricing rule moves the street rate below it.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show min_rate schema
string | nullFloor: no pricing rule moves the street rate below it.
Variant 1: string
stringVariant 2: null
nullnamestringrequiredDisplay name of the group.
rates_changed_atstring | nullWhen the group's effective street or online rate last changed.
Format: date-time
Show rates_changed_at schema
string | nullWhen the group's effective street or online rate last changed.
Variant 1: string
stringVariant 2: null
nullsizeGroupSizeResponse | nullThe footprint every dimensioned unit of the group shares; null when they differ.
Show size schema
GroupSizeResponse | nullThe footprint every dimensioned unit of the group shares; null when they differ.
Variant 1: GroupSizeResponse
depth_feetstringrequiredPattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
width_feetstringrequiredPattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Variant 2: null
nullstandard_ratestring | nullBase street rate the operator set; units with no rate of their own start from it.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show standard_rate schema
string | nullBase street rate the operator set; units with no rate of their own start from it.
Variant 1: string
stringVariant 2: null
nullunitsUnitGroupMemberResponse[]Show units schema
effective_standard_ratestring | nullPattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show effective_standard_rate schema
string | nullVariant 1: string
stringVariant 2: null
nulleffective_web_ratestring | nullPattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show effective_web_rate schema
string | nullVariant 1: string
stringVariant 2: null
nullidstringrequiredFormat: uuid
is_rentablebooleanrequiredFalse while the unit is held out of inventory.
managedbooleanDefault: false
outside_guardrailsbooleanDefault: false
rate_overriddenbooleanDefault: false
standard_ratestring | nullPattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show standard_rate schema
string | nullVariant 1: string
stringVariant 2: null
nullstatusstringrequiredavailable, occupied, reserved, overlocked or maintenance.
unit_numberstringrequiredunit_type_namestring | nullShow unit_type_name schema
string | nullVariant 1: string
stringVariant 2: null
nullweb_managedbooleanDefault: false
updated_atstringrequiredWhen the group was last modified.
Format: date-time
web_managedbooleanTrue when a pricing rule adjusts the effective online rate.
Default: false
web_ratestring | nullBase online rate the operator set, optional.
Pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
Show web_rate schema
string | nullBase online rate the operator set, optional.
Variant 1: string
stringVariant 2: null
nullmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired400Validation error
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired401Unauthenticated
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired403Permission denied
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired404Not found
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired409Business logic error
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired503Temporary failure
{
"error": {
"code": "string",
"message": "string",
"details": {}
},
"meta": {
"request_id": "string"
}
}application/json
errorErrorBodyrequiredThe shape of error.* in an error response.
Show error schema
codestringrequireddetailsobject | nullShow details schema
object | nullVariant 1: object
objectVariant 2: null
nullmessagestringrequiredmetaMetarequiredEnvelope metadata. Every response carries one.
Show meta schema
request_idstringrequired