> ## 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, role and aspect on the device.



## OpenAPI

````yaml /references/device-api/v0.2.5/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.2
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  x-release-version: v0.2.5
  x-git-commit:
    sha: 19eb0d408a2b07e39e7eaedb867ed2e8836bea30
    url: >-
      https://github.com/mirurobotics/openapi/commit/19eb0d408a2b07e39e7eaedb867ed2e8836bea30
    message: >-
      docs(device): title the latest calibration download "Download Latest"
      (#471)
    author: Ben's Agent
    branch: HEAD
    dirty: false
  x-build:
    built_at: '2026-11-10T07:34:46.079962+00:00'
servers:
  - url: http://localhost/v0.2
    description: localhost
security:
  - {}
  - BearerAuth: []
paths:
  /calibrations/latest:
    get:
      tags:
        - Calibrations
      summary: List Latest
      description: >-
        List the latest calibration for each component, role and aspect on the
        device.
      operationId: listLatestCalibrations
      parameters:
        - $ref: '#/components/parameters/calibration_search_component'
        - $ref: '#/components/parameters/calibration_search_role'
        - $ref: '#/components/parameters/calibration_search_aspect'
      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.2/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.2/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
    calibration_search_role:
      name: role
      in: query
      required: false
      style: form
      explode: false
      description: >-
        The role slugs to filter by; `null` matches calibrations reported
        without a role. Role slugs are unique only within a component, so filter
        by component too to match one component's role.
      schema:
        type: array
        items:
          type: string
        example:
          - front-left
    calibration_search_aspect:
      name: aspect
      in: query
      required: false
      style: form
      explode: false
      description: >-
        The aspect slugs to filter by; `null` matches calibrations reported
        without an aspect. Aspect slugs are unique only within a component, so
        filter by component too to match one component's aspect.
      schema:
        type: array
        items:
          type: string
        example:
          - pose
  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, role and aspect.
      example:
        calibrations:
          - object: calibration
            report_id: 0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10
            component: kuka-arm
            role: front-left
            aspect: null
            serial_number: SN-1234
            reported_by: Benjamin Smidt
            reported_at: '2026-03-10T12:00:00Z'
    Calibration:
      title: Calibration
      type: object
      description: >-
        The newest calibration the device has for one component, role and
        aspect.
      required:
        - object
        - report_id
        - component
        - role
        - aspect
        - serial_number
        - reported_by
        - reported_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, as it was
            reported.
        role:
          type: string
          nullable: true
          example: front-left
          description: >-
            Slug of the role the calibrated unit fills on the device, as it was
            reported; null if no role was reported.
        aspect:
          type: string
          nullable: true
          example: pose
          description: >-
            Slug of the aspect of the unit that was calibrated, as it was
            reported; null if no aspect was reported.
        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.
      example:
        object: calibration
        report_id: 0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10
        component: kuka-arm
        role: front-left
        aspect: null
        serial_number: SN-1234
        reported_by: Benjamin Smidt
        reported_at: '2026-03-10T12:00:00Z'
  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.