> ## Documentation Index > Fetch the complete documentation index at: https://docs.ontime.hosai.app/llms.txt > Use this file to discover all available pages before exploring further. # Device detail: histogram, recent punches, 30d health > Device detail: histogram, recent punches, 30d health ## OpenAPI ````yaml /api-reference/openapi.json get /api/devices/{id} openapi: 3.1.0 info: title: ontime API description: APIs for ontime.v2 version: 1.0.0 servers: - url: https://app.ontime.hosai.app description: Production security: - apiKey: [] paths: /api/devices/{id}: get: tags: - Devices summary: 'Device detail: histogram, recent punches, 30d health' description: 'Device detail: histogram, recent punches, 30d health' operationId: getApiDevicesById parameters: - in: path name: id schema: type: string format: uuid 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)$ required: true responses: '200': description: Success content: application/json: schema: type: object properties: device: type: object properties: id: type: string format: uuid 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)$ orgId: type: string format: uuid 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)$ deviceId: type: string name: anyOf: - type: string - type: 'null' locationId: anyOf: - type: string format: uuid 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)$ - type: 'null' locationName: anyOf: - type: string - type: 'null' model: type: string kind: type: string enum: - biometric - kiosk firmware: type: string enrolledCount: type: integer minimum: -9007199254740991 maximum: 9007199254740991 lastSyncAt: anyOf: - type: string - type: 'null' status: type: string enum: - Online - Offline retiredAt: anyOf: - type: string - type: 'null' punchesToday: type: integer minimum: -9007199254740991 maximum: 9007199254740991 health: type: string enum: - online - degraded - offline - retired required: - id - orgId - deviceId - name - locationId - locationName - model - kind - firmware - enrolledCount - lastSyncAt - status - retiredAt - punchesToday - health hourly: type: array items: type: object properties: hour: type: integer minimum: -9007199254740991 maximum: 9007199254740991 count: type: integer minimum: -9007199254740991 maximum: 9007199254740991 required: - hour - count recentPunches: type: array items: type: object properties: id: type: string format: uuid 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)$ employeeId: type: string format: uuid 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)$ employeeName: type: string employeeCode: type: string timestamp: type: string direction: type: string enum: - IN - OUT source: type: string enum: - MobileGPS - SelfieGPS - Biometric - Web deviceId: anyOf: - type: string format: uuid 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)$ - type: 'null' deviceCode: anyOf: - type: string - type: 'null' lat: anyOf: - type: number - type: 'null' lng: anyOf: - type: number - type: 'null' accuracyMeters: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' geofenceStatus: type: string enum: - Inside - Outside - Pending selfieRef: anyOf: - type: string - type: 'null' reason: anyOf: - type: string - type: 'null' status: type: string enum: - Approved - Pending - Rejected conflictFlag: type: boolean required: - id - employeeId - employeeName - employeeCode - timestamp - direction - source - deviceId - deviceCode - lat - lng - accuracyMeters - geofenceStatus - selfieRef - reason - status - conflictFlag seenEmployees: type: array items: type: object properties: id: type: string format: uuid 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)$ name: type: string code: type: string lastSeen: type: string required: - id - name - code - lastSeen health30d: type: object properties: uptimePct: type: number daysActive: type: integer minimum: -9007199254740991 maximum: 9007199254740991 punches30d: type: integer minimum: -9007199254740991 maximum: 9007199254740991 avgPunchesPerActiveDay: type: number required: - uptimePct - daysActive - punches30d - avgPunchesPerActiveDay connectivity: type: object properties: status: type: string enum: - Online - Offline lastSyncAt: anyOf: - type: string - type: 'null' syncLagSeconds: anyOf: - type: integer minimum: -9007199254740991 maximum: 9007199254740991 - type: 'null' required: - status - lastSyncAt - syncLagSeconds required: - device - hourly - recentPunches - seenEmployees - health30d - connectivity components: securitySchemes: apiKey: type: http scheme: bearer bearerFormat: ont_ API key description: >- Issue keys in Settings → API. Send them as `Authorization: Bearer ont_…` (an `X-Api-Key: ont_…` header is also accepted). Session-cookie routes are used by the OnTime web apps and are shown for completeness. ````