{ "openapi": "3.1.0", "info": { "title": "TruthPulse API", "description": "Primary-source intelligence for FOIA releases, declassified archives, court records, forensic evidence, UAP disclosures, and conspiracy theory evidence briefs. Evidence-first. No spin. Global. All endpoints require x402 payment (USDC on Base mainnet) via the PAYMENT-SIGNATURE header.", "version": "1.0.0", "contact": { "url": "https://truthpulse-five.vercel.app", "email": "info@theaslangroupllc.com" } }, "servers": [ { "url": "https://truthpulse-five.vercel.app" } ], "components": { "securitySchemes": { "x402": { "type": "apiKey", "in": "header", "name": "PAYMENT-SIGNATURE", "description": "x402 payment signature (USDC on Base mainnet). Send a GET request without this header to receive a 402 with payment requirements. Sign the payment and retry." } } }, "security": [{ "x402": [] }], "paths": { "/api/truth/foia-search": { "get": { "summary": "FOIA release search", "description": "Search publicly released FOIA documents and declassified records on any topic. Covers US agencies (FBI, CIA, NSA, DEA, DOJ, DHS) plus UK, Canada, and Australia. Returns document summaries, source archives, redaction level, and where to dig deeper.", "operationId": "foiaSearch", "parameters": [ { "name": "topic", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Topic to search — e.g. MKUltra, JFK assassination, Epstein, UFO, Operation Paperclip" }, { "name": "agency", "in": "query", "required": false, "schema": { "type": "string", "default": "all" }, "description": "FBI | CIA | NSA | DEA | DOJ | DHS | all" }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string", "default": "US" }, "description": "US | UK | CA | AU | all" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" }, "description": "en | es | fr | de | ja | pt | it | nl | ko | zh | ar" } ], "responses": { "200": { "description": "FOIA release summary with sources and dig-deeper guidance" }, "402": { "description": "Payment required — x402 payment requirements returned in PAYMENT-REQUIRED header" } } } }, "/api/truth/foia-draft": { "get": { "summary": "FOIA request letter generator", "description": "Generate a complete, ready-to-submit FOIA or Freedom of Information request letter for any agency in 15+ countries. Includes statutory basis, submission portal, fee waiver language, and filing tips to maximize approval.", "operationId": "foiaDraft", "parameters": [ { "name": "records_sought", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Plain English description of the records you want" }, { "name": "agency", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Specific agency name — or leave blank to let TruthPulse recommend" }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string", "default": "US" }, "description": "US | UK | CA | AU | NZ | IE | IN | BR | DE | FR | EU" }, { "name": "requester_type", "in": "query", "required": false, "schema": { "type": "string", "default": "individual" }, "description": "individual | journalist | researcher | nonprofit" }, { "name": "fee_waiver", "in": "query", "required": false, "schema": { "type": "string", "default": "yes" }, "description": "yes | no" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Complete ready-to-submit request letter with portal URL, filing tips, and appeal rights" }, "402": { "description": "Payment required" } } } }, "/api/truth/court-case": { "get": { "summary": "Court case intelligence", "description": "Synthesize public court record information for any case: charges with exact statutes, key parties, timeline, evidence summary, verdict, sentence, and legal reasoning. Covers US federal and state courts, UK, Canada, Australia, ICC, and ECHR.", "operationId": "courtCase", "parameters": [ { "name": "case_name", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Defendant name, case name, or case number — e.g. Alex Murdaugh | State v. Myers | OJ Simpson" }, { "name": "jurisdiction", "in": "query", "required": false, "schema": { "type": "string", "default": "auto" }, "description": "US | UK | CA | AU | international | ICC | ECHR | auto" }, { "name": "focus", "in": "query", "required": false, "schema": { "type": "string", "default": "all" }, "description": "all | charges | verdict | sentence | rulings | timeline" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Structured court case brief with verdict, sentence, and statutory basis" }, "402": { "description": "Payment required" } } } }, "/api/truth/evidence-extract": { "get": { "summary": "Forensic evidence extraction", "description": "Extract and present forensic evidence exactly as entered into the court record. Toxicology levels with lethal-dose multiples, autopsy findings, ME testimony, DNA results, ballistics, and financial forensics — with zero narrative spin. Includes defense challenges and statutory relevance analysis.", "operationId": "evidenceExtract", "parameters": [ { "name": "case_name", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Defendant or case name — e.g. George Myers | Karen Read | Alex Murdaugh" }, { "name": "evidence_type", "in": "query", "required": false, "schema": { "type": "string", "default": "all" }, "description": "all | toxicology | autopsy | dna | financial | ballistics | digital" }, { "name": "jurisdiction", "in": "query", "required": false, "schema": { "type": "string", "default": "auto" }, "description": "US | UK | CA | AU | auto" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Forensic evidence brief with exact levels, ME testimony, and verdict connection" }, "402": { "description": "Payment required" } } } }, "/api/truth/declassified": { "get": { "summary": "Declassified archive search", "description": "Search and synthesize declassified government archives: CIA Reading Room, FBI Vault, NSA, National Archives (NARA), UK National Archives, and international intelligence releases. Returns key admissions, documented operations, and what remains classified.", "operationId": "declassified", "parameters": [ { "name": "topic", "in": "query", "required": true, "schema": { "type": "string" }, "description": "e.g. MKUltra | COINTELPRO | Operation Mockingbird | Iran-Contra | Watergate" }, { "name": "source", "in": "query", "required": false, "schema": { "type": "string", "default": "all" }, "description": "cia | fbi | nsa | nara | uk | all" }, { "name": "era", "in": "query", "required": false, "schema": { "type": "string", "default": "all" }, "description": "1940s | 1950s | cold-war | 1970s | 1980s | post-911 | recent | all" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Declassified archive synthesis with key admissions, documented operations, and reading room links" }, "402": { "description": "Payment required" } } } }, "/api/truth/uap-records": { "get": { "summary": "Global UAP/UFO government records", "description": "Official government disclosures on UAP/UFO incidents from the US (AARO/Pentagon), France (GEIPAN — the world's only fully public UAP investigation unit), Chile (CEFAA), Brazil Air Force, UK Ministry of Defence, and others. Sensor data, pilot testimony, official findings, and classification history.", "operationId": "uapRecords", "parameters": [ { "name": "incident", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Nimitz | Tic Tac | Roswell | AATIP | Gimbal | Rendlesham | Phoenix Lights | any — or leave blank for overview" }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string", "default": "all" }, "description": "US | FR | UK | BR | CL | AU | CA | all" }, { "name": "focus", "in": "query", "required": false, "schema": { "type": "string", "default": "all" }, "description": "incident | investigation | testimony | evidence | all" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Official UAP record synthesis with sensor data, testimony, official findings, and international corroboration" }, "402": { "description": "Payment required" } } } }, "/api/truth/conspiracy-brief": { "get": { "summary": "Conspiracy theory evidence brief", "description": "What the primary-source record actually shows about any conspiracy theory — FOIA releases, declassified documents, court records, and official investigations. Separates documented facts from unverified claims with explicit confidence levels. No editorializing.", "operationId": "conspiracyBrief", "parameters": [ { "name": "topic", "in": "query", "required": true, "schema": { "type": "string" }, "description": "JFK assassination | 9/11 Commission | Moon landing | Epstein network | Operation Paperclip | any topic" }, { "name": "depth", "in": "query", "required": false, "schema": { "type": "string", "default": "deep-dive" }, "description": "overview | deep-dive" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Evidence brief with documented facts, contested claims, confidence levels, and remaining classified material" }, "402": { "description": "Payment required" } } } }, "/api/truth/entity-network": { "get": { "summary": "Entity connection mapping", "description": "Map documented connections between individuals, organizations, and court cases using only public court records, FOIA releases, and civil litigation filings. Every connection cites its source document.", "operationId": "entityNetwork", "parameters": [ { "name": "subject", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Person or organization — e.g. Jeffrey Epstein | Harvey Weinstein | HSBC | any subject" }, { "name": "depth", "in": "query", "required": false, "schema": { "type": "string", "default": "direct" }, "description": "direct | extended" }, { "name": "include", "in": "query", "required": false, "schema": { "type": "string", "default": "all" }, "description": "individuals | organizations | cases | all" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Connection map with sourced relationships, organizations, court cases, and documented financial ties" }, "402": { "description": "Payment required" } } } }, "/api/truth/new-releases": { "get": { "summary": "Latest FOIA and court releases feed", "description": "Real-time feed of the most recent FOIA releases, declassified document batches, court docket updates, and government transparency actions globally. Ideal for agents polling daily. Each item rated by significance with a dig-deeper routing to the appropriate TruthPulse endpoint.", "operationId": "newReleases", "parameters": [ { "name": "category", "in": "query", "required": false, "schema": { "type": "string", "default": "all" }, "description": "foia | court | declassified | uap | all" }, { "name": "country", "in": "query", "required": false, "schema": { "type": "string", "default": "all" }, "description": "US | UK | CA | AU | EU | all" }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 10 }, "description": "5 | 10 | 20" }, { "name": "filter", "in": "query", "required": false, "schema": { "type": "string" }, "description": "Optional keyword filter — e.g. fentanyl | JFK | UAP" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Paginated feed of recent releases with significance ratings and dig-deeper routing" }, "402": { "description": "Payment required" } } } }, "/api/truth/media-vs-record": { "get": { "summary": "Media narrative vs. court record", "description": "Compare what mainstream media reported about a case against what the actual court record, ME testimony, and admitted evidence shows. Identifies confirmed facts, claims not supported by the record, and significant facts that received little mainstream coverage.", "operationId": "mediaVsRecord", "parameters": [ { "name": "case_or_topic", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Case name, defendant, or topic — e.g. George Floyd | Karen Read | Uvalde response | Alex Murdaugh" }, { "name": "jurisdiction", "in": "query", "required": false, "schema": { "type": "string", "default": "auto" }, "description": "US | UK | CA | AU | auto" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "Side-by-side comparison of media narrative and court record with confirmed, unsupported, and omitted findings" }, "402": { "description": "Payment required" } } } }, "/api/truth/international-foia": { "get": { "summary": "International FOI search and request drafting", "description": "Research public records and generate ready-to-submit FOI request letters for 15+ countries: UK, Canada, Australia, Germany, France, New Zealand, Ireland, India, Brazil, Japan, Netherlands, South Africa, Nigeria, EU institutions, and more. Includes statutory deadlines, exemption warnings, and appeal processes.", "operationId": "internationalFoia", "parameters": [ { "name": "topic", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Subject of the records you want — e.g. Thalidomide cover-up | colonial records | nuclear tests" }, { "name": "country", "in": "query", "required": true, "schema": { "type": "string" }, "description": "UK | CA | AU | DE | NZ | IE | IN | BR | FR | JP | EU | NL | ZA | NG" }, { "name": "include_draft", "in": "query", "required": false, "schema": { "type": "string", "default": "yes" }, "description": "yes | no" }, { "name": "lang", "in": "query", "required": false, "schema": { "type": "string", "default": "en" } } ], "responses": { "200": { "description": "FOI research brief with existing records, statutory requirements, and ready-to-submit draft request" }, "402": { "description": "Payment required" } } } } } }