cURL
curl "https://api.ionq.co/v0.4/backends/qpu.aria-1/characterizations"import requests
url = "https://api.ionq.co/v0.4/backends/{backend}/characterizations"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.ionq.co/v0.4/backends/{backend}/characterizations', 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.ionq.co/v0.4/backends/{backend}/characterizations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.ionq.co/v0.4/backends/{backend}/characterizations"
req, _ := http.NewRequest("GET", url, nil)
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.ionq.co/v0.4/backends/{backend}/characterizations")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ionq.co/v0.4/backends/{backend}/characterizations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"characterizations": [
{
"backend": "<string>",
"connectivity": [
[
0,
1
],
[
0,
2
],
[
10,
9
]
],
"date": "2025-06-16T00:00:00Z",
"fidelity": {
"spam": {
"median": 0.9962,
"stderr": null
}
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"qubits": 25,
"timing": {
"readout": 123,
"reset": 123,
"1q": 123,
"2q": 123,
"t1": 10,
"t2": 1
}
}
],
"pages": 123
}Backends
Get all backend characterizations
Retrieve historical characterizations for a backend.
GET
/
backends
/
{backend}
/
characterizations
cURL
curl "https://api.ionq.co/v0.4/backends/qpu.aria-1/characterizations"import requests
url = "https://api.ionq.co/v0.4/backends/{backend}/characterizations"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.ionq.co/v0.4/backends/{backend}/characterizations', 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.ionq.co/v0.4/backends/{backend}/characterizations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$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.ionq.co/v0.4/backends/{backend}/characterizations"
req, _ := http.NewRequest("GET", url, nil)
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.ionq.co/v0.4/backends/{backend}/characterizations")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.ionq.co/v0.4/backends/{backend}/characterizations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"characterizations": [
{
"backend": "<string>",
"connectivity": [
[
0,
1
],
[
0,
2
],
[
10,
9
]
],
"date": "2025-06-16T00:00:00Z",
"fidelity": {
"spam": {
"median": 0.9962,
"stderr": null
}
},
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"qubits": 25,
"timing": {
"readout": 123,
"reset": 123,
"1q": 123,
"2q": 123,
"t1": 10,
"t2": 1
}
}
],
"pages": 123
}Retrieve historical performance characterizations for a specific backend with optional date filtering and pagination. Characterizations provide snapshots of quantum hardware performance including fidelity measurements and gate operation speeds over time.
Learn more about backend characterizations.
Path Parameters
A backend where jobs can run on.
Available options:
qpu.forte-1, qpu.forte-enterprise-1 Query Parameters
Characterizations starting at this time (e.g., start=2025-12-31)
Characterizations before this time (e.g., end=2025-12-31)
How many objects to return.
Required range:
1 <= x <= 10Specify the page of results to return.
Required range:
x >= 1Was this page helpful?

