QCOS Core API Overview

Base URL

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

Authentication

All API requests require authentication via Bearer token:

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

API Versions

Version	Status	Base Path
v2	Current	/api/v2/
v1	Deprecated	/api/v1/

Response Format

All responses are JSON:

{
  "success": true,
  "data": { ... },
  "meta": {
    "request_id": "req_abc123",
    "timestamp": "2026-02-06T12:00:00Z"
  }
}

Error Format

{
  "success": false,
  "error": {
    "code": "INVALID_CIRCUIT",
    "message": "Circuit validation failed",
    "details": { ... }
  }
}

Rate Limits

Plan	Requests/min	Evaluations/month
Free	60	1,000
Pro	300	50,000
Enterprise	Unlimited	Custom

Endpoints Summary

Category	Endpoints	Description
Optimization	5	Circuit optimization
Backends	3	Backend management
Jobs	4	Job management
Evidence	3	Evidence system
Health	2	Health checks

---

Quick Examples

Submit Optimization

curl -X POST https://api.softquantus.com/api/v2/optimize \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "qasm": "OPENQASM 2.0; ...",
    "backend": "ionq_simulator",
    "shots": 1024
  }'

List Backends

curl https://api.softquantus.com/api/v2/backends \
  -H "Authorization: Bearer $API_KEY"

Get Job Status

curl https://api.softquantus.com/api/v2/jobs/{job_id} \
  -H "Authorization: Bearer $API_KEY"

---

SDKs

Official SDKs handle authentication and provide typed interfaces:

• Python SDK
• JavaScript SDK (coming soon)

---

© 2024-2026 SoftQuantus Innovative OÜ