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": "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": "{\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-29.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

string

required

Slug of the component the calibrated unit belongs to, as it was reported.

Example:

"arm"

role

string | null

required

Slug of the role the calibrated unit fills on the device, as it was reported; null if no role was reported.

Example:

"front-left"

aspect

string | null

required

Slug of the aspect of the unit that was calibrated, as it was reported; null if no aspect was reported.

Example:

"pose"

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"

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": "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": "{\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

Config Instances

Config Schemas

Config Types

Deployments

Devices

Provisioning Tokens

Git Commits

Groups

Principals

Releases

Authorizations

Headers

Path Parameters

Query Parameters

Response