ACOS API Overview

Base URL

Production: https://api.softquantus.com/api/v2/acos
Sandbox:    https://sandbox.softquantus.com/api/v2/acos

Authentication

All requests require Bearer token:

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.softquantus.com/api/v2/acos/...

---

Endpoints Summary

Attestation

Method	Endpoint	Description
POST	/attest	Generate attestation for job
GET	/attestation/{id}	Get attestation certificate
GET	/attestations	List attestations

Quality Monitoring

Method	Endpoint	Description
GET	/quality/{backend}	Get current backend quality
GET	/quality/{backend}/history	Get quality history
GET	/quality/all	Get all backends quality

Optimization

Method	Endpoint	Description
POST	/optimize	Optimize with current calibration
GET	/calibration/{backend}	Get calibration data

Alerts

Method	Endpoint	Description
POST	/alerts	Create quality alert
GET	/alerts	List alerts
DELETE	/alerts/{id}	Delete alert

---

Quick Examples

Generate Attestation

curl -X POST https://api.softquantus.com/api/v2/acos/attest \
  -H "Authorization: Bearer $QCOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_id": "job_xyz789",
    "include_metrics": true
  }'

Response:

{
  "success": true,
  "data": {
    "attestation_id": "att_abc123",
    "job_id": "job_xyz789",
    "backend": "ionq_simulator",
    "quality_score": 0.95,
    "fidelity_estimate": 0.97,
    "created_at": "2026-02-06T12:00:00Z",
    "metrics": {
      "circuit_depth": 15,
      "gate_count": 28,
      "two_qubit_gates": 8,
      "estimated_error_rate": 0.02
    },
    "calibration": {
      "timestamp": "2026-02-06T10:00:00Z",
      "age_minutes": 120
    },
    "signature": {
      "algorithm": "ML-DSA-65",
      "value": "base64:..."
    }
  }
}

Get Backend Quality

curl https://api.softquantus.com/api/v2/acos/quality/ionq_aria \
  -H "Authorization: Bearer $QCOS_API_KEY"

Response:

{
  "success": true,
  "data": {
    "backend": "ionq_aria",
    "status": "optimal",
    "fidelity": 0.97,
    "trend": "stable",
    "calibration": {
      "last_calibration": "2026-02-06T10:00:00Z",
      "next_expected": "2026-02-06T14:00:00Z"
    },
    "metrics": {
      "single_qubit_fidelity": 0.9995,
      "two_qubit_fidelity": 0.98,
      "readout_fidelity": 0.99,
      "t1_us": 10000,
      "t2_us": 1000
    }
  }
}

Optimize with Calibration

curl -X POST https://api.softquantus.com/api/v2/acos/optimize \
  -H "Authorization: Bearer $QCOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "qasm": "OPENQASM 2.0; ...",
    "backend": "ionq_aria",
    "use_current_calibration": true
  }'

Response:

{
  "success": true,
  "data": {
    "original_depth": 25,
    "optimized_depth": 18,
    "improvement": 0.28,
    "expected_fidelity": 0.96,
    "optimized_qasm": "OPENQASM 2.0; ...",
    "calibration_used": "2026-02-06T10:00:00Z"
  }
}

Create Quality Alert

curl -X POST https://api.softquantus.com/api/v2/acos/alerts \
  -H "Authorization: Bearer $QCOS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "fidelity-alert",
    "backend": "ionq_aria",
    "metric": "fidelity",
    "condition": "below",
    "threshold": 0.90,
    "webhook": "https://your-app.com/alert"
  }'

---

Attestation Schema

{
  "attestation_id": "string",
  "job_id": "string",
  "backend": "string",
  "quality_score": "float (0-1)",
  "fidelity_estimate": "float (0-1)",
  "created_at": "ISO 8601",
  "metrics": {
    "circuit_depth": "integer",
    "gate_count": "integer",
    "two_qubit_gates": "integer",
    "estimated_error_rate": "float"
  },
  "calibration": {
    "timestamp": "ISO 8601",
    "age_minutes": "integer"
  },
  "signature": {
    "algorithm": "ML-DSA-65",
    "value": "base64"
  }
}

---

Quality Status Values

Status	Description
optimal	Fidelity > 95%
good	Fidelity 90-95%
degraded	Fidelity 80-90%
poor	Fidelity < 80%
maintenance	Backend in maintenance

---

Error Codes

Code	HTTP	Description
JOB_NOT_FOUND	404	Job ID not found
BACKEND_NOT_FOUND	404	Backend ID not found
ATTESTATION_UNAVAILABLE	400	Cannot attest this job
CALIBRATION_STALE	400	Calibration too old
OPTIMIZATION_FAILED	500	Optimization error

---

© 2024-2026 SoftQuantus Innovative OÜ