Lodging

List lodging

GET/v1/teams/{teamId}/lodging

Lists lodging records for a team.

Required scopes: lodging:read

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`query.date`	`string:date` Optional local date filter in YYYY-MM-DD format. Returns lodging records whose local check-in/check-out date range overlaps this date.
`query.limit`	`integer` Maximum number of records to return. Defaults to 50 and is capped at 200.
`query.cursor`	`string` Cursor returned by page.nextCursor from the previous list response.

Response 200

`data`	`object[]`
`data[].name`	`string` Lodging record display name.
`data[].label`	`string \| null` Optional lodging label displayed above the lodging name.
`data[].sortOrder`	`integer \| null` Optional numeric sort order for ordering lodging records.
`data[].confirmationNumber`	`string` Hotel confirmation number.
`data[].location`	`object` Hotel or lodging location details.
`data[].location.name`	`string` Hotel or lodging location display name.
`data[].location.address`	`string` Street address or human-readable lodging location address.
`data[].location.placeId`	`string` Google Places ID when available.
`data[].location.latitude`	`number` Optional lodging latitude in decimal degrees.
`data[].location.longitude`	`number` Optional lodging longitude in decimal degrees.
`data[].location.timezone`	`object` IANA timezone identifier for the lodging location, such as America/Chicago. RoadOps uses this timezone to display check-in and check-out UTC timestamps in local time.
`data[].checkInTime`	`string` ISO 8601 UTC timestamp for the lodging event. Send the timestamp in UTC, typically ending in Z; RoadOps uses location.timezone to display the corresponding local time in the app.
`data[].checkOutTime`	`string` ISO 8601 UTC timestamp for the lodging event. Send the timestamp in UTC, typically ending in Z; RoadOps uses location.timezone to display the corresponding local time in the app.
`data[].contact`	`object` Primary lodging contact.
`data[].contact.name`	`string` Contact person's name.
`data[].contact.title`	`string` Contact person's role or job title.
`data[].contact.phone`	`string` Contact phone number.
`data[].contact.email`	`string:email` Contact email address.
`data[].contact.notes`	`string` Short notes about this contact.
`data[].contacts`	`object[]` Additional lodging contacts.
`data[].contacts[].name`	`string` Contact person's name.
`data[].contacts[].title`	`string` Contact person's role or job title.
`data[].contacts[].phone`	`string` Contact phone number.
`data[].contacts[].email`	`string:email` Contact email address.
`data[].contacts[].notes`	`string` Short notes about this contact.
`data[].roomCount`	`integer` Expected number of rooms reserved for this lodging block.
`data[].rooms`	`object[]` Rooming-list entries associated with this lodging record.
`data[].rooms[].id`	`string:uuid` Stable room identifier.
`data[].rooms[].roomType`	`string` Room type or rooming-list label, such as King, Double Queen, or Bus room.
`data[].rooms[].roomNumber`	`string` Assigned room number, when known.
`data[].rooms[].bagTag`	`string` Bag tag or luggage label associated with this room.
`data[].rooms[].confirmationNumber`	`string` Room-specific confirmation number, when different from the lodging record.
`data[].rooms[].checkInDate`	`string` Room-specific check-in date in YYYY-MM-DD format, in the lodging timezone.
`data[].rooms[].eta`	`string` Estimated room arrival time in HH:mm 24-hour local time.
`data[].rooms[].checkOutDate`	`string` Room-specific check-out date in YYYY-MM-DD format, in the lodging timezone.
`data[].rooms[].etd`	`string` Estimated room departure time in HH:mm 24-hour local time.
`data[].rooms[].occupants`	`string` Names or notes identifying the people assigned to this room.
`data[].rooms[].notes`	`string` Room-specific notes.
`data[].notes`	`string` General lodging notes.
`data[].sourceMetadata`	`object` Optional integration metadata retained with the lodging record.
`data[].visibility`	`object` Optional visibility rules for the lodging record.
`data[].visibility.groupIds`	`string:uuid[]`
`data[].visibility.userIds`	`string:uuid[]`
`data[].id`	`string:uuid`
`data[].orgId`	`string:uuid`
`data[].isDeleted`	`boolean`
`data[].version`	`integer` Current lodging aggregate version.
`data[].createdAt`	`string:date-time` ISO 8601 timestamp when the lodging record was created.
`data[].createdBy`	`string` User identifier that created the lodging record.
`data[].updatedAt`	`string:date-time` ISO 8601 timestamp when the lodging record was last updated.
`data[].updatedBy`	`string` User identifier that last updated the lodging record.
`data[].cursor`	`integer` Latest event-ledger cursor projected into this lodging record.
`page`	`object`
`page.limit`	`integer` Maximum number of records returned in this page.
`page.nextCursor`	`string \| null` Cursor to pass as the next request's cursor query parameter, or null when there are no more results.
`meta`	`object`
`meta.cursor`	`number \| null` Highest record cursor represented by this response.

Response: List lodging

{
  "data": [
    {
      "id": "00000000-0000-4000-8000-000000000921",
      "name": "Downtown Hotel",
      "label": "Drivers",
      "sortOrder": 1,
      "confirmationNumber": "HTL123",
      "location": {
        "name": "Downtown Hotel",
        "address": "401 Union St, Nashville, TN",
        "timezone": "America/Chicago"
      },
      "checkInTime": "2026-09-14T20:00:00.000Z",
      "checkOutTime": "2026-09-15T15:00:00.000Z",
      "contacts": [],
      "roomCount": 2,
      "rooms": [
        {
          "id": "00000000-0000-4000-8000-000000000922",
          "roomType": "King",
          "confirmationNumber": "HTL123-1",
          "checkInDate": "2026-09-14",
          "checkOutDate": "2026-09-15",
          "occupants": "Tour manager"
        }
      ],
      "notes": "Late checkout requested.",
      "orgId": "00000000-0000-4000-8000-000000000100",
      "isDeleted": false,
      "createdBy": "00000000-0000-4000-8000-000000000101",
      "createdAt": "2026-09-01T12:00:00.000Z",
      "updatedBy": "00000000-0000-4000-8000-000000000101",
      "updatedAt": "2026-09-01T12:00:00.000Z",
      "version": 1,
      "cursor": 87234
    }
  ],
  "page": {
    "limit": 50,
    "nextCursor": null
  },
  "meta": {
    "cursor": 87234
  }
}

Create lodging

POST/v1/teams/{teamId}/lodging

Accepts a command to create a lodging record.

Required scopes: lodging:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`name`required	`string` Lodging record display name.
`label`	`string \| null` Optional lodging label displayed above the lodging name.
`sortOrder`	`integer \| null` Optional numeric sort order for ordering lodging records.
`confirmationNumber`	`string` Hotel confirmation number.
`location`required	`object` Hotel or lodging location details.
`location.name`	`string` Hotel or lodging location display name.
`location.address`required	`string` Street address or human-readable lodging location address.
`location.placeId`	`string` Google Places ID when available.
`location.latitude`	`number` Optional lodging latitude in decimal degrees.
`location.longitude`	`number` Optional lodging longitude in decimal degrees.
`location.timezone`	`object` IANA timezone identifier for the lodging location, such as America/Chicago. RoadOps uses this timezone to display check-in and check-out UTC timestamps in local time.
`checkInTime`required	`string` ISO 8601 UTC timestamp for the lodging event. Send the timestamp in UTC, typically ending in Z; RoadOps uses location.timezone to display the corresponding local time in the app.
`checkOutTime`required	`string` ISO 8601 UTC timestamp for the lodging event. Send the timestamp in UTC, typically ending in Z; RoadOps uses location.timezone to display the corresponding local time in the app.
`contact`	`object` Primary lodging contact.
`contact.name`required	`string` Contact person's name.
`contact.title`	`string` Contact person's role or job title.
`contact.phone`	`string` Contact phone number.
`contact.email`	`string:email` Contact email address.
`contact.notes`	`string` Short notes about this contact.
`contacts`required	`object[]` Additional lodging contacts.
`contacts[].name`required	`string` Contact person's name.
`contacts[].title`	`string` Contact person's role or job title.
`contacts[].phone`	`string` Contact phone number.
`contacts[].email`	`string:email` Contact email address.
`contacts[].notes`	`string` Short notes about this contact.
`roomCount`	`integer` Expected number of rooms reserved for this lodging block.
`rooms`required	`object[]` Rooming-list entries associated with this lodging record.
`rooms[].id`required	`string:uuid` Stable room identifier.
`rooms[].roomType`required	`string` Room type or rooming-list label, such as King, Double Queen, or Bus room.
`rooms[].roomNumber`	`string` Assigned room number, when known.
`rooms[].bagTag`	`string` Bag tag or luggage label associated with this room.
`rooms[].confirmationNumber`	`string` Room-specific confirmation number, when different from the lodging record.
`rooms[].checkInDate`	`string` Room-specific check-in date in YYYY-MM-DD format, in the lodging timezone.
`rooms[].eta`	`string` Estimated room arrival time in HH:mm 24-hour local time.
`rooms[].checkOutDate`	`string` Room-specific check-out date in YYYY-MM-DD format, in the lodging timezone.
`rooms[].etd`	`string` Estimated room departure time in HH:mm 24-hour local time.
`rooms[].occupants`	`string` Names or notes identifying the people assigned to this room.
`rooms[].notes`	`string` Room-specific notes.
`notes`	`string` General lodging notes.
`sourceMetadata`	`object` Optional integration metadata retained with the lodging record.
`visibility`	`object` Optional visibility rules for the lodging record.
`visibility.groupIds`	`string:uuid[]`
`visibility.userIds`	`string:uuid[]`
`id`	`string:uuid` Optional caller-supplied lodging ID. RoadOps generates one when omitted.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Request: Create lodging

{
  "id": "00000000-0000-4000-8000-000000000921",
  "name": "Downtown Hotel",
  "label": "Drivers",
  "sortOrder": 1,
  "confirmationNumber": "HTL123",
  "location": {
    "name": "Downtown Hotel",
    "address": "401 Union St, Nashville, TN",
    "timezone": "America/Chicago"
  },
  "checkInTime": "2026-09-14T20:00:00.000Z",
  "checkOutTime": "2026-09-15T15:00:00.000Z",
  "contacts": [],
  "roomCount": 2,
  "rooms": [
    {
      "id": "00000000-0000-4000-8000-000000000922",
      "roomType": "King",
      "confirmationNumber": "HTL123-1",
      "checkInDate": "2026-09-14",
      "checkOutDate": "2026-09-15",
      "occupants": "Tour manager"
    }
  ],
  "notes": "Late checkout requested."
}

Response: Create lodging

{
  "commandId": "00000000-0000-4000-8000-000000000010",
  "resourceId": "00000000-0000-4000-8000-000000000921",
  "resourceType": "lodging",
  "status": "applied",
  "aggregateVersion": 2,
  "cursor": 87234,
  "links": {
    "refetch": "/v1/teams/00000000-0000-4000-8000-000000000100/lodging/00000000-0000-4000-8000-000000000921"
  }
}

Retrieve lodging

GET/v1/teams/{teamId}/lodging/{lodgingId}

Returns one lodging record by ID.

Required scopes: lodging:read

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.lodgingId`required	`string:uuid` Lodging identifier.

Response 200

`data`	`object`
`data.name`	`string` Lodging record display name.
`data.label`	`string \| null` Optional lodging label displayed above the lodging name.
`data.sortOrder`	`integer \| null` Optional numeric sort order for ordering lodging records.
`data.confirmationNumber`	`string` Hotel confirmation number.
`data.location`	`object` Hotel or lodging location details.
`data.location.name`	`string` Hotel or lodging location display name.
`data.location.address`	`string` Street address or human-readable lodging location address.
`data.location.placeId`	`string` Google Places ID when available.
`data.location.latitude`	`number` Optional lodging latitude in decimal degrees.
`data.location.longitude`	`number` Optional lodging longitude in decimal degrees.
`data.location.timezone`	`object` IANA timezone identifier for the lodging location, such as America/Chicago. RoadOps uses this timezone to display check-in and check-out UTC timestamps in local time.
`data.checkInTime`	`string` ISO 8601 UTC timestamp for the lodging event. Send the timestamp in UTC, typically ending in Z; RoadOps uses location.timezone to display the corresponding local time in the app.
`data.checkOutTime`	`string` ISO 8601 UTC timestamp for the lodging event. Send the timestamp in UTC, typically ending in Z; RoadOps uses location.timezone to display the corresponding local time in the app.
`data.contact`	`object` Primary lodging contact.
`data.contact.name`	`string` Contact person's name.
`data.contact.title`	`string` Contact person's role or job title.
`data.contact.phone`	`string` Contact phone number.
`data.contact.email`	`string:email` Contact email address.
`data.contact.notes`	`string` Short notes about this contact.
`data.contacts`	`object[]` Additional lodging contacts.
`data.contacts[].name`	`string` Contact person's name.
`data.contacts[].title`	`string` Contact person's role or job title.
`data.contacts[].phone`	`string` Contact phone number.
`data.contacts[].email`	`string:email` Contact email address.
`data.contacts[].notes`	`string` Short notes about this contact.
`data.roomCount`	`integer` Expected number of rooms reserved for this lodging block.
`data.rooms`	`object[]` Rooming-list entries associated with this lodging record.
`data.rooms[].id`	`string:uuid` Stable room identifier.
`data.rooms[].roomType`	`string` Room type or rooming-list label, such as King, Double Queen, or Bus room.
`data.rooms[].roomNumber`	`string` Assigned room number, when known.
`data.rooms[].bagTag`	`string` Bag tag or luggage label associated with this room.
`data.rooms[].confirmationNumber`	`string` Room-specific confirmation number, when different from the lodging record.
`data.rooms[].checkInDate`	`string` Room-specific check-in date in YYYY-MM-DD format, in the lodging timezone.
`data.rooms[].eta`	`string` Estimated room arrival time in HH:mm 24-hour local time.
`data.rooms[].checkOutDate`	`string` Room-specific check-out date in YYYY-MM-DD format, in the lodging timezone.
`data.rooms[].etd`	`string` Estimated room departure time in HH:mm 24-hour local time.
`data.rooms[].occupants`	`string` Names or notes identifying the people assigned to this room.
`data.rooms[].notes`	`string` Room-specific notes.
`data.notes`	`string` General lodging notes.
`data.sourceMetadata`	`object` Optional integration metadata retained with the lodging record.
`data.visibility`	`object` Optional visibility rules for the lodging record.
`data.visibility.groupIds`	`string:uuid[]`
`data.visibility.userIds`	`string:uuid[]`
`data.id`	`string:uuid`
`data.orgId`	`string:uuid`
`data.isDeleted`	`boolean`
`data.version`	`integer` Current lodging aggregate version.
`data.createdAt`	`string:date-time` ISO 8601 timestamp when the lodging record was created.
`data.createdBy`	`string` User identifier that created the lodging record.
`data.updatedAt`	`string:date-time` ISO 8601 timestamp when the lodging record was last updated.
`data.updatedBy`	`string` User identifier that last updated the lodging record.
`data.cursor`	`integer` Latest event-ledger cursor projected into this lodging record.
`meta`	`object`
`meta.cursor`	`integer` Highest record cursor represented by this response.

Response: Retrieve lodging

{
  "data": {
    "id": "00000000-0000-4000-8000-000000000921",
    "name": "Downtown Hotel",
    "label": "Drivers",
    "sortOrder": 1,
    "confirmationNumber": "HTL123",
    "location": {
      "name": "Downtown Hotel",
      "address": "401 Union St, Nashville, TN",
      "timezone": "America/Chicago"
    },
    "checkInTime": "2026-09-14T20:00:00.000Z",
    "checkOutTime": "2026-09-15T15:00:00.000Z",
    "contacts": [],
    "roomCount": 2,
    "rooms": [
      {
        "id": "00000000-0000-4000-8000-000000000922",
        "roomType": "King",
        "confirmationNumber": "HTL123-1",
        "checkInDate": "2026-09-14",
        "checkOutDate": "2026-09-15",
        "occupants": "Tour manager"
      }
    ],
    "notes": "Late checkout requested.",
    "orgId": "00000000-0000-4000-8000-000000000100",
    "isDeleted": false,
    "createdBy": "00000000-0000-4000-8000-000000000101",
    "createdAt": "2026-09-01T12:00:00.000Z",
    "updatedBy": "00000000-0000-4000-8000-000000000101",
    "updatedAt": "2026-09-01T12:00:00.000Z",
    "version": 1,
    "cursor": 87234
  },
  "meta": {
    "cursor": 87234
  }
}

Update lodging

PATCH/v1/teams/{teamId}/lodging/{lodgingId}

Accepts a command to update lodging fields.

Required scopes: lodging:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.lodgingId`required	`string:uuid` Lodging identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Request body (application/json)

`expectedVersion`	`integer` Optional aggregate version guard.
`updates`required	`object` Lodging fields to update.
`updates.name`	`string` Updated lodging display name.
`updates.label`	`string \| null` Updated lodging label displayed above the lodging name, or null to clear it.
`updates.sortOrder`	`integer \| null` Updated numeric sort order for ordering lodging records, or null to clear it.
`updates.confirmationNumber`	`string \| null` Updated hotel confirmation number, or null to clear it.
`updates.location`	`object` Updated hotel or lodging location details.
`updates.location.name`	`string` Hotel or lodging location display name.
`updates.location.address`required	`string` Street address or human-readable lodging location address.
`updates.location.placeId`	`string` Google Places ID when available.
`updates.location.latitude`	`number` Optional lodging latitude in decimal degrees.
`updates.location.longitude`	`number` Optional lodging longitude in decimal degrees.
`updates.location.timezone`	`object` IANA timezone identifier for the lodging location, such as America/Chicago. RoadOps uses this timezone to display check-in and check-out UTC timestamps in local time.
`updates.checkInTime`	`string` Updated ISO 8601 UTC check-in timestamp. Send the timestamp in UTC, typically ending in Z; RoadOps uses location.timezone to display the corresponding local time in the app.
`updates.checkOutTime`	`string` Updated ISO 8601 UTC check-out timestamp. Send the timestamp in UTC, typically ending in Z; RoadOps uses location.timezone to display the corresponding local time in the app.
`updates.contact`	`object \| null` Updated primary lodging contact, or null to clear it.
`updates.contact.name`	`string` Contact person's name.
`updates.contact.title`	`string` Contact person's role or job title.
`updates.contact.phone`	`string` Contact phone number.
`updates.contact.email`	`string:email` Contact email address.
`updates.contact.notes`	`string` Short notes about this contact.
`updates.contacts`	`object[]` Updated additional lodging contacts.
`updates.contacts[].name`required	`string` Contact person's name.
`updates.contacts[].title`	`string` Contact person's role or job title.
`updates.contacts[].phone`	`string` Contact phone number.
`updates.contacts[].email`	`string:email` Contact email address.
`updates.contacts[].notes`	`string` Short notes about this contact.
`updates.roomCount`	`integer \| null` Updated expected room count, or null to clear it.
`updates.rooms`	`object[]` Updated rooming-list entries.
`updates.rooms[].id`required	`string:uuid` Stable room identifier.
`updates.rooms[].roomType`required	`string` Room type or rooming-list label, such as King, Double Queen, or Bus room.
`updates.rooms[].roomNumber`	`string` Assigned room number, when known.
`updates.rooms[].bagTag`	`string` Bag tag or luggage label associated with this room.
`updates.rooms[].confirmationNumber`	`string` Room-specific confirmation number, when different from the lodging record.
`updates.rooms[].checkInDate`	`string` Room-specific check-in date in YYYY-MM-DD format, in the lodging timezone.
`updates.rooms[].eta`	`string` Estimated room arrival time in HH:mm 24-hour local time.
`updates.rooms[].checkOutDate`	`string` Room-specific check-out date in YYYY-MM-DD format, in the lodging timezone.
`updates.rooms[].etd`	`string` Estimated room departure time in HH:mm 24-hour local time.
`updates.rooms[].occupants`	`string` Names or notes identifying the people assigned to this room.
`updates.rooms[].notes`	`string` Room-specific notes.
`updates.notes`	`string \| null` Updated lodging notes, or null to clear them.
`updates.visibility`	`object \| null` Updated visibility rules, or null to clear them.
`updates.visibility.groupIds`	`string:uuid[]`
`updates.visibility.userIds`	`string:uuid[]`

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.

Delete lodging

DELETE/v1/teams/{teamId}/lodging/{lodgingId}

Accepts a command to delete a lodging record.

Required scopes: lodging:write

Parameters

`path.teamId`required	`string:uuid` Team identifier.
`path.lodgingId`required	`string:uuid` Lodging identifier.
`header.Idempotency-Key`	`string:uuid` Optional caller-generated UUID used to make mutation retries safe. Reuse the same UUID only when retrying the same request.

Response 202

`commandId`	`string:uuid` Command identifier accepted into the RoadOps command ledger.
`resourceId`	`string:uuid` Identifier of the resource targeted by the command.
`resourceType`	`string` Resource type targeted by the command.
`status`	`"applied"` Command dispatch status.
`aggregateVersion`	`integer` Aggregate version produced by the accepted command.
`cursor`	`integer` Event-ledger cursor for the accepted update. Refetch until returned records reach this cursor.
`links`	`object`
`links.refetch`	`string` Relative URL to refetch the affected resource.