CSV Integration Schema: Occupancy

Last updated: October 5, 2026

This is the format for Occupancies (housing assignments / residencies) coming out of Housing.Cloud — and the format for importing them during a managed migration. One row per bed. Version 1.

Column

Type

Required

Notes

building

string

Yes

buildingId

string

No

The building code in the SIS

suite

string

No

room

string

Yes

bed

string

Yes

sisId

string

Yes

schoolEmail

string

Yes

externalTermId

string

No

The SIS term code; populated if the Cycle has one configured

dateStart / dateEnd

date

Yes

GMT

dateAssigned

date

Yes (Import Only)

GMT

dateMovedIn / dateMovedOut

date

No

GMT

status

string

No

A complete, valid Inventory path is required to resolve the correct internal bed — inventory naming is bounded by its parent's namespace (building → room → bed).

Delivery

Egress · filename occupancy_yyyy_mm_dd_{uuid}.csv. Ethos equivalent: housing-assignments (v16; Banner also uses housing-requests).

Attachments