Home / Documentation / API Reference

API Documentation

Complete reference for The Architect platform API. All endpoints return structured JSON. Authentication is required for write operations. Read endpoints are publicly accessible.

Base URL: https://quantumqub.comFormat: JSONAuth: Session cookie / Bearer token

Data Providers

The platform aggregates data from multiple verified public sources. Scores are computed transparently — never invented.

World Bank Open DataPrimary

13 macro indicators (GDP, population, inflation, education, trade, energy)

PrismAPIEnrichment

Real-time macro summary, trade flows, government spending, economic calendar

GeoNamesGeography

Geographic entities — countries, cities, councils, coordinates, populations

Companies House (UK)Registry

Official UK company registry data, directors, filings

SEC EDGAR (US)Registry

US public company filings, 10-K, 10-Q, annual reports

OpenCorporatesRegistry

Global corporate data aggregation from 140+ jurisdictions

Country Scoring Formula

Every country score is computed from real World Bank data using this transparent formula:

30%

Economic Velocity

GDP per capita, unemployment rate, trade openness

30%

Societal Wellness

Life expectancy, education enrollment, internet access, poverty rate

25%

Geopolitical Stability

Military spending, battle deaths, GINI inequality

15%

Resource Autonomy

Renewable energy %, food production, CO₂ per capita

Formula: Score = 0.30 × EconomicVelocity + 0.30 × SocietalWellness + 0.25 × GeopoliticalStability + 0.15 × ResourceAutonomy

Country & Geography

Access country scores, geographic data, and governance metrics for every nation.

GET/api/v2/geo/open-country-score

Compute or retrieve a country's governance score from World Bank data. Uses 13 indicators across 4 pillars.

Parameters: country (ISO 2-letter code), persist (0 or 1)

GET/api/v2/geo/prism-country

Fetch macro-economic data from PrismAPI: GDP, inflation, trade, government spending, economic calendar.

Parameters: country (ISO code), date (range like 2020:2026)

GET/api/v2/geo

List all countries, continents, and geographic zones with their current scores.

Parameters: continent, sort, limit

GET/api/v2/scores/country/{code}

Full score ledger: formula, latest snapshot, all sources, facts, and computed metrics.

Parameters: code (ISO country code)

Enterprise & Companies

GET/api/v2/enterprise

List all registered enterprises with scores, financials, and metadata.

Parameters: domain (companies|nonprofits|government), sort, limit

GET/api/v2/enterprise/{slug}

Full enterprise profile including governance score, financial summary, and source attribution.

Parameters: slug (enterprise identifier)

GET/api/v2/enterprise/{slug}/financials

Financial metrics: revenue, costs, assets, debt, and fiscal year data.

Parameters: slug

POST/api/v2/enterprise/register

Parameters: JSON body with company details

GET/api/v2/enterprise/{slug}/sources

All verified data sources contributing to this enterprise's score.

Parameters: slug

POST/api/v2/enterprise/{slug}/score/recompute

Trigger a re-computation of the enterprise governance score.

Parameters: slug

AI & Security

Deep Prompt Inspection (DPI) powered by Veea Lobster Trap technology. Every AI interaction is inspected for threats.

POST/api/ai/dpi/inspect

Run DPI inspection on any text. Returns risk score, matched rules, detected intent, and action (ALLOW/DENY/LOG).

Parameters: JSON: content, direction (ingress|egress), compliancePack

GET/api/ai/dpi/inspect

Get all DPI rules, compliance packs, and engine configuration.

Parameters: none

GET/api/ai/dpi/history

Retrieve audit trail of all DPI inspections with full metadata.

Parameters: none

POST/api/ai/assistant

AI governance assistant powered by Google Gemini. Analyzes data and provides structured insights.

Parameters: JSON: messages array

Governance & Voting

Council claims, institutional membership, voting, and democratic governance workflows.

POST/api/v2/governance/claims

Claim a governance position (council, minister, presidency). Requires authentication.

Parameters: JSON: role, country, council_id

POST/api/v2/governance/join

Request to join a council or institution as a member.

Parameters: JSON: institution_id, role

GET/api/v2/govledger/transactions

Browse the governance ledger — all recorded governance actions and decisions.

Parameters: type, country, limit

POST/api/v2/voting

Cast a vote on an active proposal or governance motion.

Parameters: JSON: proposal_id, vote (for|against|abstain)

Scoring Engine

The transparent scoring system. Every score traces back to verifiable sources. No data is invented.

GET/api/v2/scores/{subjectType}/{subjectId}

Get complete score breakdown for any entity (country, enterprise, citizen).

Parameters: subjectType, subjectId

GET/api/v2/stats

Platform-wide statistics: total entities, average scores, data freshness.

Parameters: none

GET/api/v2/open-data

List all open data sources used by the platform with trust tiers and registration requirements.

Parameters: none

Authentication & Identity

eID-based authentication, WebAuthn passkeys, biometric verification, and KYC integration.

GET/api/auth/session

Get current authenticated session details.

Parameters: none

POST/api/v2/auth/passkey/register/options

Start WebAuthn/passkey registration flow.

Parameters: none

POST/api/v2/auth/eid/start

Initiate European eID authentication via OIDC.

Parameters: JSON: provider, returnUrl

POST/api/v2/kyc/didit/start

Start KYC verification via Didit provider.

Parameters: JSON: level (basic|enhanced)

Authentication

Read endpoints — Most GET endpoints are publicly accessible without authentication. They return real, verifiable data from public sources.

Write endpoints — POST/PUT/DELETE operations require authentication via session cookie (web) or API key (programmatic access).

Supported auth methods:

European eID (via OIDC providers — 27 EU member states)
WebAuthn passkeys (hardware security keys, biometric)
Biometric verification (face/fingerprint via Didit KYC)
Traditional email + password (with mandatory 2FA)