Skip to main content
GET
Get a unit (parent or child) by id

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Query Parameters

extend
enum<string>[]

Extend options (JSON-encoded array, e.g. ?extend=["category"]):

  • "actions-info": Projects { canBeUpdated } for the current viewer.
  • "updatable-fields": Per-field write rules for this unit in its current state.
  • "parent": Parent unit summary (null on a parent unit).
  • "tags": The unit's tags with their tag type.
  • "logo-url": Presigned download URL for the unit logo (null when no logo).
  • "position": Structural context under the unit: buildings → plans → plan items.
  • "qrcode": Sticker scan URL for the QR code linked to this unit (null when none).
  • "responsibles": Adds responsibles - the users responsible for this element.
Available options:
actions-info,
updatable-fields,
parent,
tags,
logo-url,
position,
qrcode,
responsibles
whereUnitIds
string<uuid>[]

Narrow the result to the requested unit ids.

Maximum array length: 250
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Example:
whereITIds
string<uuid>[]

Narrow the result to units linked to the requested technical installations.

Maximum array length: 250
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Example:

Response

Default Response

id
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
ref
string
required
Maximum string length: 40
Pattern: ^[A-Z]+-[1-9]\d*(?:-[A-Z]+-[1-9]\d*)*$
type
enum<string>
required
Available options:
parent,
child
name
string
required
Required string length: 1 - 150
description
string | null
required
Maximum string length: 1000
serialNumber
string | null
required
Required string length: 1 - 20
openedAt
string<date-time> | null
required
logo
object | null
required
activityTypes
enum<string>[]
required
Available options:
J,
L,
M,
N,
O,
P,
R,
S,
T,
U,
V,
W,
X,
Y,
PA,
CTS,
SG,
OA,
REF,
PS,
GHA,
GHO,
GHR,
GHS,
GHTC,
GHU,
GHW1,
GHW2,
GHZ,
ITGH
classifications
enum<string>[]
required
Available options:
erp,
ert,
igh,
icpe,
hab,
other
totalSurfaceArea
integer | null
required
Required range: 0 < x <= 9007199254740991
publicCapacity
integer | null
required
Required range: 0 <= x <= 9007199254740991
privateCapacity
integer | null
required
Required range: 0 <= x <= 9007199254740991
pinCode
string
required
Pattern: ^\d{6}$
pinCodeRequired
boolean
required
accessInstructions
string | null
required
Maximum string length: 1000
organizationId
string<uuid>
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
createdByUserId
string<uuid> | null
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
addressCountry
string | null
required
Required string length: 1 - 200
addressCity
string | null
required
Required string length: 1 - 200
addressPostalCode
string | null
required
Required string length: 1 - 20
addressStreet
string | null
required
Required string length: 1 - 200
category
enum<string> | null
required
Available options:
1,
2,
3,
4,
5
commissionPeriodicityYears
required
Available options:
3
parentId
string<uuid> | null
required
Pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
sortOrder
integer | null
required
Required range: -9007199254740991 <= x <= 9007199254740991
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
actions
object
updatableFields
object
parent
object | null
tags
object[]
logoUrl
string<uri> | null
position
object
qrcode
object | null
responsibles
object[]