> ## 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.

# Get

> Retrieve a calibration by ID.

| Scope | Required |
| - | - |
| `calibrations:read` | Yes |


## OpenAPI

````yaml /references/platform-api/2026-10-28.yaml get /calibrations/{calibration_id}
openapi: 3.0.3
info:
  title: Miru Platform API
  description: The API between Miru and any external client
  version: 2026-10-28.everglades
  license:
    name: MIT
    url: https://opensource.org/licenses/MIT
  x-release-version: 2026-10-28.everglades
  x-git-commit:
    sha: da19e118a12d7f7069f89d7781c0085522789785
    url: >-
      https://github.com/mirurobotics/openapi/commit/da19e118a12d7f7069f89d7781c0085522789785
    message: >-
      chore(stlc): seal custom-code tracking files (#381)


      Automated by the stlc generate workflow: a push-to-main or manual

      `workflow_dispatch` publish re-sealed custom code, updating the tracking

      files under `sdkgen/*/stainless/custom-code/`. Publishing targets the

      private staging repos. Safe to merge - this PR's head branch

      `stlc/seal-tracking` is skipped by the generate workflow's skip-bot

      guard in `detect`, and on merge the push loop-breaker `guard` sees only

      custom-code changes and runs no rebuild.


      <!-- codesmith:footer -->

      ---

      <a

      href="https://app.blacksmith.sh/mirurobotics/codesmith/openapi/pr/381?autoLogin=true&ref=codesmith_pr_footer"><picture><source

      media="(prefers-color-scheme: dark)"

      srcset="https://pr-comments-assets.blacksmith.sh/codesmith/view-with-codesmith-dark-v3.svg"><source

      media="(prefers-color-scheme: light)"

      srcset="https://pr-comments-assets.blacksmith.sh/codesmith/view-with-codesmith-light-v3.svg"><img

      alt="View with [code]smith"

      src="https://pr-comments-assets.blacksmith.sh/codesmith/view-with-codesmith-dark-v3-3x.png"

      width="162" height="28"></picture></a> <a

      href="https://backend.blacksmith.sh/track/enable-autofix?expires=1795806796&installation_model_id=425273&pr_number=381&ref=codesmith_pr_footer&repository=mirurobotics%2Fopenapi&return_to=https%3A%2F%2Fgithub.com%2Fmirurobotics%2Fopenapi%2Fpull%2F381&signature=22576ca30b7a9b5179ba686401e8539245f08cdc1682091295fe21383a37f37a"><picture><source

      media="(prefers-color-scheme: dark)"

      srcset="https://pr-comments-assets.blacksmith.sh/codesmith/autofix-with-codesmith-dark.svg"><source

      media="(prefers-color-scheme: light)"

      srcset="https://pr-comments-assets.blacksmith.sh/codesmith/autofix-with-codesmith-light.svg"><img

      alt="Autofix with [code]smith"

      src="https://pr-comments-assets.blacksmith.sh/codesmith/autofix-with-codesmith-dark-3x.png"

      width="190" height="28"></picture></a>

      <sup>Need help on this PR? Tag <code>@codesmith</code> with what you

      need.</sup>


      <!-- codesmith:autofix:disabled -->

      <!-- /codesmith:footer -->


      Co-authored-by: stlc-sealback-bot[bot]
      <298483487+stlc-sealback-bot[bot]@users.noreply.github.com>

      Co-authored-by: Ben <ben@mirurobotics.com>
    author: stlc-sealback-bot[bot]
    branch: HEAD
    dirty: false
  x-build:
    built_at: '2026-10-28T22:21:18.805528+00:00'
servers:
  - url: https://api.mirurobotics.com/beta
    description: Miru Platform API
security:
  - ApiKeyAuth: []
paths:
  /calibrations/{calibration_id}:
    parameters:
      - $ref: '#/components/parameters/MiruVersion'
    get:
      tags:
        - Calibrations
      summary: Get
      description: Retrieve a calibration by ID.
      operationId: getCalibration
      parameters:
        - $ref: '#/components/parameters/calibration_id'
        - $ref: '#/components/parameters/calibration_expansions'
      responses:
        '200':
          description: Successfully retrieved the calibration.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Calibration'
components:
  parameters:
    MiruVersion:
      name: Miru-Version
      in: header
      required: true
      schema:
        type: string
        example: 2026-10-28.everglades
      description: The API version the client was built against.
    calibration_id:
      name: calibration_id
      in: path
      required: true
      description: The unique identifier of the calibration.
      schema:
        type: string
        example: cal_123
    calibration_expansions:
      name: expand
      in: query
      required: false
      description: Fields to expand on the calibration.
      schema:
        type: array
        items:
          $ref: '#/components/schemas/CalibrationExpansion'
        example:
          - content
  schemas:
    Calibration:
      title: Calibration
      description: >-
        One calibration reported by a device for a unit of a component.
        Calibrations are immutable and append-only; a device's history is kept
        per component, role, and aspect. Content is at most 1 MiB.
      allOf:
        - $ref: '#/components/schemas/BaseCalibration'
        - type: object
          properties:
            content:
              allOf:
                - $ref: '#/components/schemas/InstanceContent'
              description: >-
                The calibration's content. Expand using `expand=content` in the
                query string.
      example:
        object: calibration
        id: cal_123
        device_id: dvc_123
        component_id: cmp_123
        role_id: cmp_rol_123
        aspect_id: null
        serial_number: SN-1234
        digest: >-
          sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
        deployment_id: dpl_123
        operator_id: opr_123
        report_id: 0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10
        reported_at: '2021-01-01T00:00:00Z'
        created_at: '2021-01-01T00:00:00Z'
        content:
          format: json
          data: |
            {
              "x": 0.412,
              "y": -0.087,
              "z": 0.256,
              "roll": 0.0,
              "pitch": 0.0,
              "yaw": 1.571
            }
    CalibrationExpansion:
      type: string
      enum:
        - content
      x-enum-varnames:
        - CALIBRATION_EXPAND_CONTENT
    BaseCalibration:
      title: Calibration
      type: object
      required:
        - object
        - id
        - device_id
        - component_id
        - role_id
        - aspect_id
        - serial_number
        - digest
        - deployment_id
        - operator_id
        - report_id
        - reported_at
        - created_at
      properties:
        object:
          type: string
          enum:
            - calibration
          example: calibration
          x-stainless-const: true
          description: The object type, which is always `calibration`.
        id:
          type: string
          example: cal_123
          description: ID of the calibration, generated by Miru.
        device_id:
          type: string
          example: dvc_123
          description: ID of the device that reported the calibration.
        component_id:
          type: string
          example: cmp_123
          description: ID of the component the calibrated unit belongs to.
        role_id:
          type: string
          nullable: true
          example: cmp_rol_123
          description: >-
            ID of the component role the calibrated unit fills; null if no role
            was reported.
        aspect_id:
          type: string
          nullable: true
          example: cmp_asp_123
          description: >-
            ID of the component aspect that was calibrated; 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.
        digest:
          type: string
          example: >-
            sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
          description: >-
            Digest of the content, formatted as `sha256:` followed by 64
            lowercase hex characters.
        deployment_id:
          type: string
          nullable: true
          example: dpl_123
          description: >-
            ID of the deployment the device was on when it reported the
            calibration; null if it had none or the deployment was deleted.
        operator_id:
          type: string
          nullable: true
          example: opr_123
          description: >-
            ID of the operator the device reported as running the calibration;
            null if no operator was reported.
        report_id:
          type: string
          format: uuid
          example: 0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10
          description: ID the agent gave the report this calibration came from.
        reported_at:
          type: string
          format: date-time
          example: '2021-01-01T00:00:00Z'
          description: >-
            Timestamp of when the calibration was reported to the agent on the
            device. The agent may upload it much later, for example after an
            outage, so this can be well before `created_at`.
        created_at:
          type: string
          format: date-time
          example: '2021-01-01T00:00:00Z'
          description: Timestamp of when Miru recorded the calibration.
    InstanceContent:
      title: Instance Content
      type: object
      required:
        - format
        - data
      properties:
        format:
          $ref: '#/components/schemas/InstanceFormat'
        data:
          type: string
          description: The content's values, serialized in `format`.
          example: |
            {
              "enable_autonomy": true,
              "enable_remote_control": true,
              "max_payload_kg": 10.0
            }
      example:
        format: json
        data: |
          {
            "enable_autonomy": true,
            "enable_remote_control": true,
            "max_payload_kg": 10.0
          }
    InstanceFormat:
      title: Instance Format
      type: string
      description: >
        The serialization format of config content. A config instance is written
        to the device filesystem in this format.

        - `json`: standard JSON.

        - `yaml`: YAML 1.2.

        - `jsonc`: JSON with comments (JSON plus `//` and `/* */` comment
        syntax).

        - `xml`: XML.

        - `csv`: comma-separated values (RFC 4180).

        - `text`: plain, unstructured text with no specific format.
      enum:
        - json
        - yaml
        - jsonc
        - xml
        - csv
        - text
      x-enum-varnames:
        - INSTANCE_FORMAT_JSON
        - INSTANCE_FORMAT_YAML
        - INSTANCE_FORMAT_JSONC
        - INSTANCE_FORMAT_XML
        - INSTANCE_FORMAT_CSV
        - INSTANCE_FORMAT_TEXT
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: The API key to use for authentication.

````

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