> ## 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-29.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-29.everglades license: name: MIT url: https://opensource.org/licenses/MIT x-release-version: 2026-10-29.everglades x-git-commit: sha: fa872feb1c97431ace4e4f5636eea0856b5d73f3 url: >- https://github.com/mirurobotics/openapi/commit/fa872feb1c97431ace4e4f5636eea0856b5d73f3 message: >- feat(platform)!: name calibration components, roles and aspects by slug (#387) author: Ben's Agent branch: HEAD dirty: false x-build: built_at: '2026-10-29T05:41:56.762337+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-29.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 type: object 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. required: - object - id - device_id - component - role - aspect - serial_number - digest - 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: type: string example: 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. digest: type: string example: >- sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 description: >- Digest of the content, formatted as `sha256:` followed by 64 lowercase hex characters. 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. 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: arm role: front-left aspect: null serial_number: SN-1234 digest: >- sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855 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 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.