Quantum Cloud API Reference

Full technical documentation for Quantum Cloud API endpoints, request formats, and integration examples.

Base URL

api.quantumcloud.io/v2

Authentication

All requests require an API key in the header:

Authorization: Bearer

Available Endpoints

POST
/api/v2/circuits

Create a new quantum circuit

Initializes a quantum computation workflow with specified parameters.

Request Body

{
  "qubits": 4,
  "entanglement": "ghz",
  "algorithm": "shor",
  "shots": 1024,
  "format": "json"
}

Response

{
  "id": "circuit_abcd1234",
  "status": "queued",
  "created": "2025-08-20T14:30:00Z",
  "est_completion": "2025-08-20T15:30:00Z"
}
GET
/api/v2/circuits/{id}

Fetch circuit execution results

Retrieve results and statistics for a completed quantum computation.

Parameters:
string id

Response

{
  "id": "circuit_ghs987",
  "output": {
    "counts": {"0000": 256, "1111": 768},
    "avg_time": "98.5ms"
  },
  "status": "completed"
}

Python Example

quantum_sdk.py
import requests
from typing import Dict

class QuantumAPI:
def __init__(self, api_key:str):
self.headers = {'Authorization': f'Bearer {api_key}'}

def create_circuit(self, config:Dict) -> Dict:
return requests.post(
'https://api.quantumcloud.io/v2/circuits',
json=config,
headers=self.headers
).json()

def get_results(self, circuit_id:str) -> Dict:
return requests.get(
f'https://api.quantumcloud.io/v2/circuits/{circuit_id}',
headers=self.headers
).json()

Test Your First API Call

Try our interactive API console to test circuits:
```