Level 1 · Connected

Sizes, prices and units

The centre's sizes, each unit's status and price, and every change in real time.

Sizes first, then units. If you send sizes or units for a centre you haven't sent yet, the response is 409 facility_not_ready.

Its sizes

PUT /facilities/{facilityId}/unit-types, with version and all its unitTypes: each one's id, its name (“S”, “Size M”), up to 40 characters, and, if you like, its color (#RRGGBB). If you don't send it, the portal picks one. Those not included are removed.

unit-types

{
  "version": "t-2026-10-26",
  "unitTypes": [
    { "id": "S", "name": "Size S", "color": "#F2B33D" },
    { "id": "M", "name": "Size M", "color": "#1E6B52" }
  ]
}

Its units

PUT /facilities/{facilityId}/units, with version and all its units. Those not included are removed.

Field	Type	Required	Notes
`id`	text	Yes	Unique in the centre. The same as its `data-unit-id` in the floor plan
`number`	text	Yes	The one the tenant sees on the door: “21”, “A-3”
`areaM2`	number	Yes	Its floor area. The portal puts it in its category: Closet, Dressing room, Room, Studio, Flat or House
`status`	`available`, `occupied` or `blocked`	Yes	Free, rented, or not available right now
`monthlyPrice`	amount or `null`	Yes	Its monthly price, with or without VAT according to `pricesIncludeVat`. `null` if it isn't rented through the portal
`unitTypeId`	text	No	Its size, one of `unit-types`
`floorId`	text	No	Its floor, if the floor plan has several

Nothing about tenants is ever sent.

A unit that changes

PUT /facilities/{facilityId}/units/{unitId}, with the same fields, as soon as it changes: it's rented, freed or its price changes. That way the portal has the free units in real time.

curl -X PUT https://api.findqbox.com/connect/v1/facilities/madrid-01/units/T-021 \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"number": "21", "areaM2": 2.6, "status": "occupied", "monthlyPrice": 49, "unitTypeId": "S"}'

VAT

Send prices as the centre has them, with or without VAT, and say which in pricesIncludeVat. The portal always calculates and shows the final price, with its country's VAT.