> ## Documentation Index > Fetch the complete documentation index at: https://docs.internal.nscale.com/llms.txt > Use this file to discover all available pages before exploring further. # List device lifecycle events > List one device's status history, newest first. One row per observed change to ``operational_status``, ``health_status`` or ``inventory_status`` (``kind``), including the baseline row recorded when history tracking started. ``ended_at`` is when the next row of the same kind superseded it; null marks the row describing the current value. ``kind`` narrows to a comma-separated subset; omit it for the full interleaved timeline. ## OpenAPI ````yaml /openapi/fleet-manager-openapi.yaml get /api/v1/devices/{id}/lifecycle-events/ openapi: 3.0.3 info: title: Fleet Manager API version: 1.0.0 description: API for the Nscale Fleet Manager servers: [] security: [] paths: /api/v1/devices/{id}/lifecycle-events/: get: tags: - Devices summary: List device lifecycle events description: >- List one device's status history, newest first. One row per observed change to ``operational_status``, ``health_status`` or ``inventory_status`` (``kind``), including the baseline row recorded when history tracking started. ``ended_at`` is when the next row of the same kind superseded it; null marks the row describing the current value. ``kind`` narrows to a comma-separated subset; omit it for the full interleaved timeline. operationId: api_v1_devices_lifecycle_events_list parameters: - in: path name: id schema: type: string format: uuid description: A UUID string identifying this device. required: true - in: query name: kind schema: type: array items: $ref: '#/components/schemas/DeviceLifecycleEventKindEnum' description: >- Restrict the timeline to these status kinds. Multiple values may be separated by commas. Omit for the full interleaved timeline. explode: false style: form - name: limit required: false in: query description: Number of results to return per page. schema: type: integer maximum: 500 minimum: 1 - name: page required: false in: query description: A page number within the paginated result set. schema: type: integer responses: '200': content: application/json: schema: $ref: '#/components/schemas/PaginatedDeviceLifecycleEventList' description: '' '400': description: Validation error. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Authentication credentials were not provided or are invalid. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: You do not have permission to perform this action. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Not found. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - oauth2: - device:read - cookieAuth: [] components: schemas: DeviceLifecycleEventKindEnum: enum: - operational_status - health_status - inventory_status type: string description: |- * `operational_status` - Operational status * `health_status` - Health status * `inventory_status` - Inventory status PaginatedDeviceLifecycleEventList: type: object required: - count - results properties: count: type: integer example: 123 next: type: string nullable: true format: uri example: http://api.example.org/accounts/?page=4 previous: type: string nullable: true format: uri example: http://api.example.org/accounts/?page=2 results: type: array items: $ref: '#/components/schemas/DeviceLifecycleEvent' ErrorResponse: type: object description: >- Uniform error body for every 4xx/5xx response. `detail` is a human-readable message, always present, safe to display to end users. `code` is the machine-readable identifier. `field_errors` lists per-input-field validation messages and is empty for non-field errors (auth, permission, not-found, conflict, server). required: - detail - code - field_errors properties: detail: type: string code: $ref: '#/components/schemas/ErrorCodeEnum' field_errors: type: array items: $ref: '#/components/schemas/FieldError' DeviceLifecycleEvent: type: object description: One observed status transition with the moment it was superseded. properties: id: type: string format: uuid readOnly: true kind: allOf: - $ref: '#/components/schemas/DeviceLifecycleEventKindEnum' readOnly: true value: allOf: - $ref: '#/components/schemas/DeviceLifecycleEventValueEnum' readOnly: true created_at: type: string format: date-time readOnly: true ended_at: type: string format: date-time readOnly: true nullable: true description: >- When the next row of the same kind was recorded. Null for the row that describes the current value; measure that state's duration to now. required: - created_at - ended_at - id - kind - value ErrorCodeEnum: type: string description: >- Stable machine-readable error identifier. New members may be added within this API version; clients must tolerate unknown values. enum: - error - invalid - parse_error - authentication_failed - not_authenticated - permission_denied - not_found - method_not_allowed - not_acceptable - unsupported_media_type - conflict - enrollment_infrastructure_reference_pending - enrollment_infrastructure_reference_changed - unprocessable_entity - throttled - service_unavailable FieldError: type: object description: One input field's validation messages. required: - field - messages properties: field: type: string description: >- Dotted path to the offending input field, or to the collection row when the whole row is invalid (e.g. `filters.end_date`, `memberships.0.role`, `memberships.0`). messages: type: array minItems: 1 items: type: string DeviceLifecycleEventValueEnum: enum: - unknown - quarantine - validation - available - in_use - delegated - pending_handover - drained - failed - healthy - degraded - critical - planned - staged - active - offline - rma - returned - decommissioning - decommissioned - inventory type: string description: |- * `unknown` - Unknown * `quarantine` - Quarantine * `validation` - Validation * `available` - Available * `in_use` - In Use * `delegated` - Delegated * `pending_handover` - Pending Handover * `drained` - Drained * `failed` - Failed * `healthy` - Healthy * `degraded` - Degraded * `critical` - Critical * `planned` - Planned * `staged` - Staged * `active` - Active * `offline` - Offline * `rma` - RMA * `returned` - Returned * `decommissioning` - Decommissioning * `decommissioned` - Decommissioned * `inventory` - Inventory securitySchemes: oauth2: type: oauth2 flows: {} cookieAuth: type: apiKey in: cookie name: sessionid ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.