{"openapi":"3.1.0","info":{"title":"XCTP Quantum Computing API — Involved Involutions","version":"2.0.0","description":"Quantum circuit emulation powered by XCTP. 50,000 qubits, 22 gates, 4 engines, OpenQASM 2.0.","contact":{"name":"Involved Involutions","email":"Paul@Clearseassolutions.com","url":"https://involvedinvolutions.com"},"license":{"name":"Proprietary","url":"https://involvedinvolutions.com/terms"}},"paths":{"/api/health":{"get":{"summary":"Health","operationId":"health_api_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}}}}}},"/api/v1/jobs":{"post":{"summary":"Submit Job","operationId":"submit_job_api_v1_jobs_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CircuitRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobStatus"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/jobs/{job_id}":{"get":{"summary":"Get Job","description":"Retrieve job results. Requires the same API key or IP used to submit.","operationId":"get_job_api_v1_jobs__job_id__get","parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string","title":"Job Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/run":{"post":{"summary":"Run Sync","description":"Synchronous execution -- blocks until complete. Best for small circuits.","operationId":"run_sync_api_v1_run_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CircuitRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/run-qasm":{"post":{"summary":"Run Qasm","description":"Execute a circuit from an OpenQASM 2.0 string.\n\nAccepts standard QASM 2.0 syntax. Qiskit users: pass qc.qasm() directly.","operationId":"run_qasm_api_v1_run_qasm_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/QASMRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResult"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/run-file":{"post":{"summary":"Run File","description":"Upload a .qasm or .json circuit for execution.\n\nSend raw QASM or JSON as the request body with appropriate Content-Type.\nInclude api_key and shots as query parameters.","operationId":"run_file_api_v1_run_file_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobResult"}}}}}}},"/api/v1/demo/presets":{"get":{"summary":"Demo Presets","description":"List available demo presets. No authentication required.","operationId":"demo_presets_api_v1_demo_presets_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/demo/run/{preset}":{"post":{"summary":"Demo Run","description":"Run a preset circuit without an API key. Rate limited to 20/min per IP.","operationId":"demo_run_api_v1_demo_run__preset__post","parameters":[{"name":"preset","in":"path","required":true,"schema":{"type":"string","title":"Preset"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/engines":{"get":{"summary":"List Engines","description":"List available execution engines.","operationId":"list_engines_api_v1_engines_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/info":{"get":{"summary":"Api Info","description":"Full API capabilities — designed for programmatic discovery by AI agents.","operationId":"api_info_api_v1_info_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/signup":{"post":{"summary":"Signup","description":"Create a free account. Returns an API key with 1 minute free compute.","operationId":"signup_api_v1_signup_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupRequest"}}},"required":true},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SignupResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/account/{api_key}":{"get":{"summary":"Get Account","description":"Check account status and usage. Key must match Authorization header.","operationId":"get_account_api_v1_account__api_key__get","parameters":[{"name":"api_key","in":"path","required":true,"schema":{"type":"string","title":"Api Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/checkout/unlimited":{"post":{"summary":"Checkout Unlimited","description":"Create Stripe Checkout for $300k/month Unlimited tier.","operationId":"checkout_unlimited_api_v1_checkout_unlimited_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/checkout/quote":{"post":{"summary":"Checkout Quote","description":"Create Stripe Checkout for custom quote (Half the Competition).","operationId":"checkout_quote_api_v1_checkout_quote_post","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/api/v1/checkout/upgrade/{api_key}":{"post":{"summary":"Checkout Upgrade","description":"Upgrade an existing account to Unlimited via Stripe Checkout.","operationId":"checkout_upgrade_api_v1_checkout_upgrade__api_key__post","parameters":[{"name":"api_key","in":"path","required":true,"schema":{"type":"string","title":"Api Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/api/v1/usage":{"get":{"summary":"Usage Status","description":"Check compute usage for authenticated account.","operationId":"usage_status_api_v1_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/signup":{"get":{"summary":"Signup Page","operationId":"signup_page_signup_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/":{"get":{"summary":"Landing","operationId":"landing__get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/playground":{"get":{"summary":"Playground","operationId":"playground_playground_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}},"/docs-page":{"get":{"summary":"Docs Page","operationId":"docs_page_docs_page_get","responses":{"200":{"description":"Successful Response","content":{"text/html":{"schema":{"type":"string"}}}}}}}},"components":{"schemas":{"CircuitRequest":{"properties":{"num_qubits":{"type":"integer","maximum":50000.0,"minimum":1.0,"title":"Num Qubits","description":"Number of qubits (1-50,000)"},"gates":{"items":{"$ref":"#/components/schemas/GateOp"},"type":"array","title":"Gates","description":"Ordered list of gate operations"},"shots":{"type":"integer","maximum":100000.0,"minimum":1.0,"title":"Shots","description":"Number of measurement shots","default":1024},"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key","description":"API key for paid tiers"},"engine":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engine","description":"Engine: auto (default), sparse (exact ≤50q), cnta (geometric O(N)), tee (legacy)","default":"auto"}},"type":"object","required":["num_qubits","gates"],"title":"CircuitRequest"},"GateOp":{"properties":{"gate":{"type":"string","title":"Gate","description":"Gate name: h, x, y, z, s, t, sdg, tdg, id, rx, ry, rz, p, u1, u2, u3, cx, cz, cp, swap, ccx, qft, barrier"},"target":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Target","description":"Target qubit index"},"control":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Control","description":"Control qubit (for cx, ccx, cp)"},"control2":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Control2","description":"Second control (for ccx)"},"target2":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Target2","description":"Second target (for swap)"},"angle":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Angle","description":"Rotation angle in radians (for rz, rx, ry, p, cp)"}},"type":"object","required":["gate"],"title":"GateOp"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HealthResponse":{"properties":{"status":{"type":"string","title":"Status"},"engine":{"type":"string","title":"Engine"},"version":{"type":"string","title":"Version"},"max_qubits":{"type":"integer","title":"Max Qubits"},"gate_count":{"type":"integer","title":"Gate Count","default":22},"engines":{"type":"integer","title":"Engines","default":4},"signup":{"type":"string","title":"Signup","default":"/api/v1/signup"},"info":{"type":"string","title":"Info","default":"/api/v1/info"}},"type":"object","required":["status","engine","version","max_qubits"],"title":"HealthResponse"},"JobResult":{"properties":{"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","title":"Status"},"counts":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"title":"Counts"},"num_qubits":{"type":"integer","title":"Num Qubits","default":0},"total_shots":{"type":"integer","title":"Total Shots","default":0},"execution_time_ms":{"type":"number","title":"Execution Time Ms","default":0.0},"backend":{"type":"string","title":"Backend","default":"xctp-v2"},"engine_version":{"type":"string","title":"Engine Version","default":"XCTP-2.0"},"tier":{"type":"string","title":"Tier","default":"free"},"trial_remaining_sec":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Trial Remaining Sec"},"beta_uses_remaining":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Beta Uses Remaining"}},"type":"object","required":["job_id","status"],"title":"JobResult"},"JobStatus":{"properties":{"job_id":{"type":"string","title":"Job Id"},"status":{"type":"string","title":"Status"},"message":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Message"}},"type":"object","required":["job_id","status"],"title":"JobStatus"},"QASMRequest":{"properties":{"qasm":{"type":"string","title":"Qasm","description":"OpenQASM 2.0 circuit string"},"shots":{"type":"integer","maximum":100000.0,"minimum":1.0,"title":"Shots","description":"Number of measurement shots","default":1024},"api_key":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Api Key","description":"API key for paid tiers"},"engine":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Engine","description":"Engine: auto (default), sparse (exact ≤50q), cnta (geometric O(N)), tee (legacy)","default":"auto"}},"type":"object","required":["qasm"],"title":"QASMRequest"},"SignupRequest":{"properties":{"email":{"type":"string","maxLength":254,"title":"Email"},"name":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Name"},"company":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Company"}},"type":"object","required":["email"],"title":"SignupRequest"},"SignupResponse":{"properties":{"api_key":{"type":"string","title":"Api Key"},"tier":{"type":"string","title":"Tier"},"email":{"type":"string","title":"Email"},"message":{"type":"string","title":"Message"}},"type":"object","required":["api_key","tier","email","message"],"title":"SignupResponse"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}},"servers":[{"url":"https://xctp-api-629322111689.us-central1.run.app","description":"Production"}]}