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

# List Latest

> List the latest calibration for each component on the device.



## OpenAPI

````yaml /references/device-api/v0.3.0/api.yaml get /calibrations/latest
openapi: 3.0.3
info:
  title: Miru Agent API
  description: >-
    The API between the Miru Agent and any external client living on the same
    device as the Miru Agent. On Linux the agent serves it over the Unix socket
    `/run/miru/miru.sock` with no authentication. Over loopback TCP, which is on
    by default on Windows at `127.0.0.1:6478`, every route requires
    `Authorization: Bearer <token>`. Clients read the port and token from the
    agent's discovery file, `%ProgramData%\Miru\device-api\device-api.json` on
    Windows; the token changes every time the agent starts.
  version: v0.3
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  x-release-version: v0.3.0
  x-git-commit:
    sha: 13ce9431f6c8183218bb62bcfe1d025852c08de6
    url: >-
      https://github.com/mirurobotics/openapi/commit/13ce9431f6c8183218bb62bcfe1d025852c08de6
    message: 'chore(device): bump the Device API version (#518)'
    author: Ben's Agent
    branch: HEAD
    dirty: false
  x-build:
    built_at: '2026-11-17T04:03:13.976979+00:00'
servers:
  - url: http://localhost/v0.3
    description: localhost
security:
  - {}
  - BearerAuth: []
paths:
  /calibrations/latest:
    get:
      tags:
        - Calibrations
      summary: List Latest
      description: List the latest calibration for each component on the device.
      operationId: listLatestCalibrations
      parameters:
        - $ref: '#/components/parameters/calibration_search_component'
      responses:
        '200':
          description: Successfully listed the latest calibrations.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/LatestCalibrationsResponse'
      x-codeSamples:
        - lang: curl
          label: curl (Linux)
          source: |-
            curl \
              --unix-socket /run/miru/miru.sock \
              --request GET \
              --url http://localhost/v0.3/calibrations/latest
        - lang: powershell
          label: PowerShell (Windows)
          source: >-
            $api = Get-Content -Raw
            "$env:ProgramData\Miru\device-api\device-api.json" |
            ConvertFrom-Json; `

            Invoke-RestMethod -Method Get `
              -Uri "http://127.0.0.1:$($api.port)/v0.3/calibrations/latest" `
              -Headers @{ Authorization = "Bearer $($api.token)" }
components:
  parameters:
    calibration_search_component:
      name: component
      in: query
      required: false
      style: form
      explode: false
      description: The component slugs to filter by.
      schema:
        type: array
        items:
          type: string
        example:
          - kuka-arm
  schemas:
    LatestCalibrationsResponse:
      title: Latest Calibrations Response
      type: object
      required:
        - calibrations
      properties:
        calibrations:
          type: array
          items:
            $ref: '#/components/schemas/Calibration'
          description: The latest calibrations, one for each component.
      example:
        calibrations:
          - object: calibration
            report_id: 0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10
            component: kuka-arm
            serial_number: SN-1234
            reported_by: Benjamin Smidt
            reported_at: '2026-03-10T12:00:00Z'
            invalidated_at: null
    Calibration:
      title: Calibration
      type: object
      description: The newest calibration the device has for one component.
      required:
        - object
        - report_id
        - component
        - serial_number
        - reported_by
        - reported_at
        - invalidated_at
      properties:
        object:
          type: string
          enum:
            - calibration
          example: calibration
          x-stainless-const: true
          description: The object type, which is always `calibration`.
        report_id:
          type: string
          format: uuid
          example: 0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10
          description: >-
            ID the agent gave the report this calibration came from. Download
            the content with it.
        component:
          type: string
          example: kuka-arm
          description: Slug of the component the calibrated unit belongs to.
        serial_number:
          type: string
          nullable: true
          maxLength: 255
          example: SN-1234
          description: >-
            Serial number of the physical unit that was calibrated, not of the
            device, such as `SN-1234`, or null if none was reported. Free text,
            at most 255 characters.
        reported_by:
          type: string
          nullable: true
          maxLength: 255
          example: Benjamin Smidt
          description: >-
            Who reported the calibration, as it was reported, such as `Benjamin
            Smidt`; null if no one was reported.
        reported_at:
          type: string
          format: date-time
          example: '2026-03-10T12:00:00Z'
          description: Timestamp of when the agent received the calibration.
        invalidated_at:
          type: string
          format: date-time
          nullable: true
          example: '2026-03-11T08:00:00Z'
          description: >-
            Timestamp of when a device app marked this calibration invalid, or
            null if it is valid. A newer calibration for the component replaces
            it.
      example:
        object: calibration
        report_id: 0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10
        component: kuka-arm
        serial_number: SN-1234
        reported_by: Benjamin Smidt
        reported_at: '2026-03-10T12:00:00Z'
        invalidated_at: null
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      description: >-
        The token from the agent's discovery file
        (`%ProgramData%\Miru\device-api\device-api.json` on Windows). Required
        over loopback TCP (`127.0.0.1:6478` by default on Windows) and accepted
        by every route; not used over the Unix socket.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.