> ## Documentation Index > Fetch the complete documentation index at: https://docs.kodelabs.com/llms.txt > Use this file to discover all available pages before exploring further. # List device write activity > Returns the values written to any point of a device, newest first. Use this to see who wrote what to a device and when. Each entry is one write to one of the device's points. Only writes made through KODE OS are listed: writes from the KODE OS app and from the KODE API, such as [Write to a point](https://docs.kodelabs.com/products/kode-api/api-reference/points/write-to-a-point.md). A value changed directly on the building automation system does not appear. Entries are sorted newest first. `asc`, `dsc`, and `q` are ignored. `from` and `to` are optional and inclusive. They need `Z` or a UTC offset, for example `2026-11-01T00:00:00.000Z`. Each entry's `time` uses the same format, so you can pass it back as `from` or `to`. There is no day limit on the range. `value` is the written value as text. The field it comes from depends on the connector, for example `value`, `level`, or `position`. A device without points returns `200` with an empty `data` array. ## OpenAPI ````yaml /openapi/kode-api.yaml get /api/v1/buildings/{buildingId}/integrations/devices/{deviceId}/activity openapi: 3.1.0 info: title: KODE API version: 1.0.0 summary: Programmatic access to KODE OS resources and operations. description: > Use the KODE API to work with buildings, data sources, connectors, devices, points, virtual devices, timeseries data, schedules, the ontology, templating, mass writes, spaces, space assignments, tenants, meters, users, actions, and AssetOps work orders. license: name: Proprietary identifier: LicenseRef-Proprietary servers: - url: https://api.kodelabs.com/kodeos description: KODE API security: - bearerAuth: [] tags: - name: Authentication description: OAuth 2.0 discovery, token, and revocation endpoints. - name: Buildings description: Buildings and their areas. - name: Data sources description: Data sources connected to a building. - name: Devices description: Devices and their points. - name: Points description: Point queries and point writes. - name: Timeseries description: Current and historical point values. - name: Actions description: Actions exposed by building data sources. - name: Work orders description: AssetOps work orders, lookups, comments, and attachments. - name: Connectors description: KODE API connectors and the devices and points ingested through them. - name: Schedules description: Schedules discovered on building data sources. - name: Templating description: Apply ontology templates to groups of points. - name: Virtual devices description: Virtual devices that group points from other devices. - name: Ontology description: Canonical types, fields, units, and connections of the KODE ontology. - name: Users description: Users of the organization and their app access. - name: Mass write description: Write values to many points across buildings, and follow each run. - name: Spaces description: Levels and space units of a building, and the meters located in them. - name: Space assignments description: Assign tenants to leasable spaces of a building for a period. - name: Tenants description: Tenants of a building, the people or companies that lease its spaces. - name: Meters description: >- Meters of a building, their space assignments, parent and child links, and readings. paths: /api/v1/buildings/{buildingId}/integrations/devices/{deviceId}/activity: get: tags: - Devices summary: List device write activity description: Returns the values written to any point of a device, newest first. operationId: listDeviceWriteActivity parameters: - $ref: '#/components/parameters/BuildingId' - $ref: '#/components/parameters/DeviceId' - $ref: '#/components/parameters/Page' - $ref: '#/components/parameters/Limit' - name: from in: query required: false description: >- Writes at or after this time, inclusive. ISO 8601 date-time with `Z` or an offset. schema: type: string format: date-time example: '2026-11-01T00:00:00.000Z' - name: to in: query required: false description: >- Writes at or before this time, inclusive. ISO 8601 date-time with `Z` or an offset. schema: type: string format: date-time example: '2026-11-02T00:00:00.000Z' - name: userId in: query required: false description: Only writes made by this user. schema: type: string example: 67c960faffaa42223163099e responses: '200': description: A page of write activity, newest first. content: application/json: schema: $ref: '#/components/schemas/PaginatedEntityWriteActivityPublic' '400': description: >- `from` or `to` is not an ISO 8601 date-time with `Z` or an offset. `from` is after `to` (`from must not be after to`). `limit` is above `200` or below `1`. `page` is below `1`. '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': description: No device with this id exists in the building. '429': $ref: '#/components/responses/TooManyRequests' components: parameters: BuildingId: name: buildingId in: path required: true description: Building identifier from List buildings. schema: type: string example: 67c960faffaa42223163099e DeviceId: name: deviceId in: path required: true description: Device identifier. schema: type: string example: ahu-01 Page: name: page in: query description: Page number to return. The first page is `1`. schema: type: integer minimum: 1 default: 1 Limit: name: limit in: query description: Maximum number of items per page. schema: type: integer minimum: 1 maximum: 200 default: 50 schemas: PaginatedEntityWriteActivityPublic: type: object properties: data: type: array items: $ref: '#/components/schemas/WriteActivityPublic' page: type: integer format: int32 example: 1 limit: type: integer format: int32 example: 50 pageCount: type: integer format: int32 example: 1 itemCount: type: integer format: int32 example: 1 WriteActivityPublic: type: object properties: time: type: string format: date-time description: >- When the write was made, in UTC with milliseconds. Accepted as `from` or `to`. example: '2026-11-01T08:15:30.123Z' user: $ref: '#/components/schemas/WriteActivityReference' description: >- The user who made the write. `name` is the user's first and last name. reason: type: - string - 'null' description: Reason recorded with the write, if any. example: null notes: type: - string - 'null' description: Note recorded with the write, if any. example: Raised setpoint for after-hours event point: $ref: '#/components/schemas/WriteActivityReference' description: The point that was written. value: type: - string - 'null' description: The written value, as text. example: '72' WriteActivityReference: type: object description: Reference to a user or point, by id and display name. properties: id: type: string example: 67c960faffaa42223163099e name: type: string example: Zone Temp Setpoint responses: Unauthorized: description: The access token is missing, invalid, or expired. Request a new token. Forbidden: description: The service account lacks permission for this building or operation. TooManyRequests: description: >- A rate-limit window is exhausted. Wait, then retry with increasing delays. securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT description: > Paste an access token from [Create an access token](/products/kode-api/api-reference/authentication/create-an-access-token). Tokens expire, so request a new one if you receive `401`. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.