> ## 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 > List calibrations. By default, results are ordered by `created_at` descending, with ties broken by `id`. | Scope | Required | | - | - | | `calibrations:read` | Yes | ## OpenAPI ````yaml /references/platform-api/2026-10-28.yaml get /calibrations 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. --- View with [code]smith Autofix with [code]smith Need help on this PR? Tag @codesmith with what you need. Co-authored-by: stlc-sealback-bot[bot] <298483487+stlc-sealback-bot[bot]@users.noreply.github.com> Co-authored-by: Ben 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: parameters: - $ref: '#/components/parameters/MiruVersion' get: tags: - Calibrations summary: List description: >- List calibrations. By default, results are ordered by `created_at` descending, with ties broken by `id`. operationId: listCalibrations parameters: - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/calibration_order_bys' - $ref: '#/components/parameters/calibration_list_expansions' - $ref: '#/components/parameters/calibration_search_device_id' - $ref: '#/components/parameters/calibration_search_component_id' - $ref: '#/components/parameters/calibration_search_role_id' - $ref: '#/components/parameters/calibration_search_aspect_id' - $ref: '#/components/parameters/calibration_search_serial_number' - $ref: '#/components/parameters/calibration_search_report_id' - $ref: '#/components/parameters/calibration_search_operator_id' responses: '200': description: Successfully listed the calibrations. content: application/json: schema: $ref: '#/components/schemas/CalibrationList' 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. offset: name: offset in: query required: false description: >- The offset of the items to return. An offset of 10 with a limit of 10 returns items 11-20. schema: type: integer default: 0 minimum: 0 example: 0 limit: name: limit in: query required: false description: >- The maximum number of items to return. A limit of 15 with an offset of 0 returns items 1-15. schema: type: integer default: 10 minimum: 1 maximum: 100 example: 10 calibration_order_bys: name: order_by in: query required: false style: form explode: false description: Sort order for the calibration results. schema: type: array items: $ref: '#/components/schemas/CalibrationOrderBy' example: - created_at:desc calibration_list_expansions: name: expand in: query required: false description: Fields to expand on each calibration in the list. schema: type: array items: $ref: '#/components/schemas/CalibrationListExpansion' example: - content calibration_search_device_id: name: device_id in: query required: false style: form explode: false description: The device IDs to filter by. schema: type: array items: type: string example: - dvc_123 calibration_search_component_id: name: component_id in: query required: false style: form explode: false description: The component IDs to filter by. schema: type: array items: type: string example: - cmp_123 calibration_search_role_id: name: role_id in: query required: false style: form explode: false description: The component role IDs to filter by. schema: type: array items: type: string example: - cmp_rol_123 calibration_search_aspect_id: name: aspect_id in: query required: false style: form explode: false description: The component aspect IDs to filter by. schema: type: array items: type: string example: - cmp_asp_123 calibration_search_serial_number: name: serial_number in: query required: false style: form explode: false description: The unit serial numbers to filter by. schema: type: array items: type: string example: - SN-1234 calibration_search_report_id: name: report_id in: query required: false style: form explode: false description: The report IDs to filter by. schema: type: array items: type: string example: - 0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10 calibration_search_operator_id: name: operator_id in: query required: false style: form explode: false description: The operator IDs to filter by. schema: type: array items: type: string example: - opr_123 schemas: CalibrationList: title: Calibration List allOf: - $ref: '#/components/schemas/PaginatedList' - type: object required: - data properties: data: type: array items: $ref: '#/components/schemas/Calibration' description: The list of calibrations. CalibrationOrderBy: type: string enum: - id:asc - id:desc - created_at:asc - created_at:desc - reported_at:asc - reported_at:desc x-enum-varnames: - CALIBRATION_ORDER_BY_ID_ASC - CALIBRATION_ORDER_BY_ID_DESC - CALIBRATION_ORDER_BY_CREATED_AT_ASC - CALIBRATION_ORDER_BY_CREATED_AT_DESC - CALIBRATION_ORDER_BY_REPORTED_AT_ASC - CALIBRATION_ORDER_BY_REPORTED_AT_DESC default: created_at:desc CalibrationListExpansion: type: string enum: - content - total_count x-enum-varnames: - CALIBRATION_LIST_EXPAND_CONTENT - CALIBRATION_LIST_EXPAND_TOTAL_COUNT PaginatedList: title: Paginated List type: object required: - object - limit - offset - has_more properties: object: type: string enum: - list example: list x-stainless-const: true description: The object type, which is always `list`. total_count: type: integer format: int64 description: >- The total number of items in the list. By default the total count is not returned. The total count must be expanded (using expand=total_count) to get the total number of items in the list. limit: type: integer description: >- The maximum number of items to return. A limit of 15 with an offset of 0 returns items 1-15. default: 10 minimum: 1 maximum: 100 offset: type: integer description: >- The offset of the items to return. An offset of 10 with a limit of 10 returns items 11-20. default: 0 minimum: 0 has_more: type: boolean description: >- True if there are more items in the list to return. False if there are no more items to return. example: false 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 } 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.