{"openapi":"3.1.0","info":{"title":"GOLDN Digital API","description":"API endpoints for the GOLDN Commercial Gold Offtake Program. Provides structured program data, document search and full-text retrieval, live gold pricing, and media assets.","version":"1.0.0","contact":{"email":"IR@GoldnDigital.io"}},"servers":[{"url":"https://docs.goldndigital.io"}],"paths":{"/api/program":{"get":{"operationId":"getProgram","summary":"Get complete program data","description":"Returns the full structured dataset for the GOLDN Commercial Gold Offtake Program, including commercial terms, collateral, milestones, team, token mechanics, and navigation.","responses":{"200":{"description":"Full program JSON"}}}},"/api/gold-price":{"get":{"operationId":"getGoldPrice","summary":"Get live gold spot price","description":"Returns the current gold spot price, previous price, change, and the margin vs. GOLDN's $1,550/oz forward price.","responses":{"200":{"description":"Gold price data"}}}},"/api/documents":{"get":{"operationId":"listDocuments","summary":"List all program documents","description":"Lists all PDF documents available in the program library with file sizes and modification dates.","responses":{"200":{"description":"Document file list"}}}},"/api/documents/library":{"get":{"operationId":"getDocumentLibrary","summary":"Get full text of all documents","description":"Returns the complete parsed text corpus of all program PDFs, including titles, page-level text, and character counts.","responses":{"200":{"description":"Full document library"}}}},"/api/documents/search":{"get":{"operationId":"searchDocuments","summary":"Search across all documents","description":"Full-text search across all program documents. Returns matching excerpts with source document, page number, and surrounding context.","parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string","minLength":2},"description":"Search query term"},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","default":10,"maximum":50},"description":"Max results"}],"responses":{"200":{"description":"Search results"}}}},"/api/documents/text/{filename}":{"get":{"operationId":"getDocumentText","summary":"Get full text of a specific document","description":"Extracts and returns the complete text of a specific PDF document by filename.","parameters":[{"name":"filename","in":"path","required":true,"schema":{"type":"string"},"description":"PDF filename"}],"responses":{"200":{"description":"Document text"}}}},"/api/media":{"get":{"operationId":"getMedia","summary":"Get media manifest","description":"Returns all photos and videos with titles, descriptions, dates, tags, and direct URLs.","responses":{"200":{"description":"Media manifest"}}}},"/llms.txt":{"get":{"operationId":"getLlmsSummary","summary":"Machine-readable program summary","description":"Plain-text summary of the entire GOLDN program optimized for LLM consumption.","responses":{"200":{"description":"Plain text summary"}}}},"/llms-full.txt":{"get":{"operationId":"getLlmsFullText","summary":"Full program content with all document text","description":"Complete program summary plus full text of every PDF document (no truncation), with table of contents and live market data.","responses":{"200":{"description":"Full text content"}}}},"/api/health":{"get":{"operationId":"getHealth","summary":"Health check endpoint","description":"Returns 200 OK with app name, version, timestamp, and uptime. Use to confirm the deployed site is accessible.","responses":{"200":{"description":"Health status"}}}}}}