GET
/
backends
/
{backend}
/
characterizations
/
{UUID}
curl "https://api.ionq.co/v0.4/backends/qpu.aria-1/characterizations/aa54e783-0a9b-4f73-ad2f-63983b6aa4a8" \
  -H "Authorization: apiKey your-api-key"
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "date": "2025-06-16T00:00:00Z",
  "backend": "qpu.aria-1",
  "qubits": 25,
  "connectivity": [
    [
      0,
      1
    ],
    [
      0,
      2
    ],
    [
      10,
      9
    ]
  ],
  "fidelity": {
    "spam": {
      "median": 0.9962,
      "stderr": null
    }
  },
  "timing": {
    "readout": 123,
    "reset": 123,
    "1q": 123,
    "2q": 123,
    "t1": 10,
    "t2": 1
  }
}

Retrieve detailed performance data for a specific characterization of a backend. This includes comprehensive fidelity metrics, gate error rates, and timing information that can help you understand the quantum hardware’s performance at a particular point in time.

Learn more about interpreting characterization data.

Authorizations

​
Authorization
string
header
required

API keys are associated with a user and can be created on the IonQ Quantum Cloud application. To authenticate, prefix your API Key with apiKey and place it in the Authorization request header. Ex: Authorization: apiKey your-api-key

Path Parameters

​
backend
enum<string>
required

A backend where jobs can run on.

Available options:
qpu.aria-1,
qpu.aria-2,
qpu.forte-1,
qpu.forte-enterprise-1
​
UUID
string
required

A UUID identifying a specific resource

Response

200 - application/json

Successfully retrieved current characterization

Quantum hardware characterization data.

GET
/
backends
/
{backend}
/
characterizations
/
{UUID}
curl "https://api.ionq.co/v0.4/backends/qpu.aria-1/characterizations/aa54e783-0a9b-4f73-ad2f-63983b6aa4a8" \
  -H "Authorization: apiKey your-api-key"
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "date": "2025-06-16T00:00:00Z",
  "backend": "qpu.aria-1",
  "qubits": 25,
  "connectivity": [
    [
      0,
      1
    ],
    [
      0,
      2
    ],
    [
      10,
      9
    ]
  ],
  "fidelity": {
    "spam": {
      "median": 0.9962,
      "stderr": null
    }
  },
  "timing": {
    "readout": 123,
    "reset": 123,
    "1q": 123,
    "2q": 123,
    "t1": 10,
    "t2": 1
  }
}

Retrieve detailed performance data for a specific characterization of a backend. This includes comprehensive fidelity metrics, gate error rates, and timing information that can help you understand the quantum hardware’s performance at a particular point in time.

Learn more about interpreting characterization data.

Authorizations

​
Authorization
string
header
required

API keys are associated with a user and can be created on the IonQ Quantum Cloud application. To authenticate, prefix your API Key with apiKey and place it in the Authorization request header. Ex: Authorization: apiKey your-api-key

Path Parameters

​
backend
enum<string>
required

A backend where jobs can run on.

Available options:
qpu.aria-1,
qpu.aria-2,
qpu.forte-1,
qpu.forte-enterprise-1
​
UUID
string
required

A UUID identifying a specific resource

Response

200 - application/json

Successfully retrieved current characterization

Quantum hardware characterization data.