> ## Documentation Index
> Fetch the complete documentation index at: https://docs.loyalty.dog/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Device

> Get device information by ID.

### Parameters:
- `device_id` (PydanticObjectId): Device ID
- `current_user` (User): Authenticated user making the request

### Returns:
- `DeviceInfo`: Device details

### Raises:
- 404: If device not found or not owned by the current user



## OpenAPI

````yaml https://api.loyalty.dog/openapi.json get /v2/devices/{device_id}
openapi: 3.1.0
info:
  title: LoyaltyDog
  description: >-

    Welcome to the LoyaltyDog API! This API provides access to our loyalty
    program features, allowing you to integrate with various platforms and
    manage your loyalty data.


    Want to query LoyaltyDog via an AI assistant (Claude, Cursor, Windsurf)? See
    the [MCP Integration guide](https://loyaltydog.ai/playground#mcp).
        
  termsOfService: https://loyalty.dog/loyalty-program-terms-service
  contact:
    name: LoyaltyDog Support
    url: https://loyalty.dog/contact-us
    email: support@loyalty.dog
  version: 1.0.1
servers:
  - url: https://api.loyalty.dog
    description: Production
security:
  - bearerAuth: []
paths:
  /v2/devices/{device_id}:
    get:
      tags:
        - Devices
      summary: Get Device
      description: |-
        Get device information by ID.

        ### Parameters:
        - `device_id` (PydanticObjectId): Device ID
        - `current_user` (User): Authenticated user making the request

        ### Returns:
        - `DeviceInfo`: Device details

        ### Raises:
        - 404: If device not found or not owned by the current user
      operationId: get_device_v2_devices__device_id__get
      parameters:
        - name: device_id
          in: path
          required: true
          schema:
            $ref: '#/components/schemas/PydanticObjectId'
        - name: authorization
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DeviceInfo'
        '404':
          description: Device not found.
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    PydanticObjectId:
      type: string
      maxLength: 24
      minLength: 24
      pattern: ^[0-9a-f]{24}$
      example: 5eb7cf5a86d9755df3a6c593
    DeviceInfo:
      properties:
        deviceId:
          type: string
          title: Deviceid
          description: Device ID
        deviceSid:
          type: string
          title: Devicesid
          description: Device SID
        deviceType:
          $ref: '#/components/schemas/DeviceType'
          description: Type of device
        deviceName:
          type: string
          title: Devicename
          description: Device name
        status:
          $ref: '#/components/schemas/DeviceStatus'
          description: Device status
        programId:
          type: string
          title: Programid
          description: Loyalty program ID
        lastSeenAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Lastseenat
          description: Last time the device was active
        activatedAt:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Activatedat
          description: When the device was activated
        locationName:
          anyOf:
            - type: string
            - type: 'null'
          title: Locationname
          description: Physical location of device
      type: object
      required:
        - deviceId
        - deviceSid
        - deviceType
        - deviceName
        - status
        - programId
      title: DeviceInfo
      description: Basic device information response.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    DeviceType:
      type: string
      enum:
        - tablet_kiosk
        - tablet
        - kiosk
      title: DeviceType
      description: Device type enumeration for tablet/kiosk devices.
    DeviceStatus:
      type: string
      enum:
        - active
        - inactive
        - blocked
        - pending_activation
      title: DeviceStatus
      description: Device status enumeration.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT access token obtained from POST /v2/token.

````