Get

GET

calibrations

{calibration_id}

Get

curl --request GET \
  --url https://api.mirurobotics.com/beta/calibrations/{calibration_id} \
  --header 'Miru-Version: <miru-version>' \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.mirurobotics.com/beta/calibrations/{calibration_id}"

headers = {
    "Miru-Version": "<miru-version>",
    "X-API-Key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Miru-Version': '<miru-version>', 'X-API-Key': '<api-key>'}
};

fetch('https://api.mirurobotics.com/beta/calibrations/{calibration_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mirurobotics.com/beta/calibrations/{calibration_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Miru-Version: <miru-version>",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mirurobotics.com/beta/calibrations/{calibration_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Miru-Version", "<miru-version>")
	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.mirurobotics.com/beta/calibrations/{calibration_id}")
  .header("Miru-Version", "<miru-version>")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mirurobotics.com/beta/calibrations/{calibration_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Miru-Version"] = '<miru-version>'
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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": "{\n  \"x\": 0.412,\n  \"y\": -0.087,\n  \"z\": 0.256,\n  \"roll\": 0.0,\n  \"pitch\": 0.0,\n  \"yaw\": 1.571\n}\n"
  }
}

Scope	Required
`calibrations:read`	Yes

Authorizations

X-API-Key

string

header

required

The API key to use for authentication.

Headers

Miru-Version

string

required

The API version the client was built against.

Example:

"2026-10-28.everglades"

Path Parameters

calibration_id

string

required

The unique identifier of the calibration.

Example:

"cal_123"

Query Parameters

expand

enum<string>[]

Fields to expand on the calibration.

Available options:

content

Example:

["content"]

Response

200 - application/json

Successfully retrieved the calibration.

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.

object

enum<string>

required

The object type, which is always calibration.

Available options:

calibration

Example:

"calibration"

string

required

ID of the calibration, generated by Miru.

Example:

"cal_123"

device_id

string

required

ID of the device that reported the calibration.

Example:

"dvc_123"

component_id

string

required

ID of the component the calibrated unit belongs to.

Example:

"cmp_123"

role_id

string | null

required

ID of the component role the calibrated unit fills; null if no role was reported.

Example:

"cmp_rol_123"

aspect_id

string | null

required

ID of the component aspect that was calibrated; null if no aspect was reported.

Example:

"cmp_asp_123"

serial_number

string | null

required

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.

Maximum string length: 255

Example:

"SN-1234"

digest

string

required

Digest of the content, formatted as sha256: followed by 64 lowercase hex characters.

Example:

"sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855"

deployment_id

string | null

required

ID of the deployment the device was on when it reported the calibration; null if it had none or the deployment was deleted.

Example:

"dpl_123"

operator_id

string | null

required

ID of the operator the device reported as running the calibration; null if no operator was reported.

Example:

"opr_123"

report_id

string<uuid>

required

ID the agent gave the report this calibration came from.

Example:

"0b6f3c2e-6a51-4e0f-9a43-2f1d7c9e8b10"

reported_at

string<date-time>

required

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.

Example:

"2021-01-01T00:00:00Z"

created_at

string<date-time>

required

Timestamp of when Miru recorded the calibration.

Example:

"2021-01-01T00:00:00Z"

content

Instance Content · object

The calibration's content. Expand using expand=content in the query string.

Show child attributes

Example:

{
  "format": "json",
  "data": "{\n  \"enable_autonomy\": true,\n  \"enable_remote_control\": true,\n  \"max_payload_kg\": 10.0\n}\n"
}

⌘I

Get

curl --request GET \
  --url https://api.mirurobotics.com/beta/calibrations/{calibration_id} \
  --header 'Miru-Version: <miru-version>' \
  --header 'X-API-Key: <api-key>'

import requests

url = "https://api.mirurobotics.com/beta/calibrations/{calibration_id}"

headers = {
    "Miru-Version": "<miru-version>",
    "X-API-Key": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {'Miru-Version': '<miru-version>', 'X-API-Key': '<api-key>'}
};

fetch('https://api.mirurobotics.com/beta/calibrations/{calibration_id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.mirurobotics.com/beta/calibrations/{calibration_id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Miru-Version: <miru-version>",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.mirurobotics.com/beta/calibrations/{calibration_id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Miru-Version", "<miru-version>")
	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.mirurobotics.com/beta/calibrations/{calibration_id}")
  .header("Miru-Version", "<miru-version>")
  .header("X-API-Key", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.mirurobotics.com/beta/calibrations/{calibration_id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Miru-Version"] = '<miru-version>'
request["X-API-Key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "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": "{\n  \"x\": 0.412,\n  \"y\": -0.087,\n  \"z\": 0.256,\n  \"roll\": 0.0,\n  \"pitch\": 0.0,\n  \"yaw\": 1.571\n}\n"
  }
}

Calibrations

Components

Component Aspects

Component Roles

Config Instances

Config Schemas

Config Types

Deployments

Devices

Provisioning Tokens

Git Commits

Groups

Principals

Releases

Authorizations

Headers

Path Parameters

Query Parameters

Response