> ## 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-11-04.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-11-04.everglades license: name: MIT url: https://opensource.org/licenses/MIT x-release-version: 2026-11-04.everglades x-git-commit: sha: e1decbb4c54ce8a4bf2f78b8728b2b10654294c9 url: >- https://github.com/mirurobotics/openapi/commit/e1decbb4c54ce8a4bf2f78b8728b2b10654294c9 message: >- feat(platform): add archived and deleted list filters, and tidy descriptions (#446) author: Ben's Agent branch: HEAD dirty: false x-build: built_at: '2026-11-05T23:04:32.018858+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-11-04.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. required: - object - id - device_id - component - role - aspect - serial_number - digest - format - 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. format: allOf: - $ref: '#/components/schemas/InstanceFormat' description: Serialization format of the calibration's content. 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, at most 1 MiB. 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 format: json 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 InstanceFormat: title: Instance Format type: string description: > The serialization format of stored content, such as a config instance or a calibration. 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 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 } 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.