GET
/
backends
/
{backend}
/
characterizations
curl "https://api.ionq.co/v0.4/backends/qpu.aria-1/characterizations"
{
  "characterizations": [
    {
      "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
      }
    }
  ],
  "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.

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

Query Parameters

​
start
string

Characterizations starting at this date (e.g., start=2025-12-31)

​
end
string

Characterizations before or equal to this date (e.g., end=2025-12-31)

​
limit
integer
default:10

How many objects to return.

Required range: 1 <= x <= 10
​
page
integer
default:1

Specify the page of results to return.

Required range: x >= 1

Response

200 - application/json

Successfully retrieved characterizations.

Response body from requesting characterization data.

GET
/
backends
/
{backend}
/
characterizations
curl "https://api.ionq.co/v0.4/backends/qpu.aria-1/characterizations"
{
  "characterizations": [
    {
      "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
      }
    }
  ],
  "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.

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

Query Parameters

​
start
string

Characterizations starting at this date (e.g., start=2025-12-31)

​
end
string

Characterizations before or equal to this date (e.g., end=2025-12-31)

​
limit
integer
default:10

How many objects to return.

Required range: 1 <= x <= 10
​
page
integer
default:1

Specify the page of results to return.

Required range: x >= 1

Response

200 - application/json

Successfully retrieved characterizations.

Response body from requesting characterization data.