{"openapi":"3.1.0","info":{"title":"Geo Petroleum Knowledge & Lead Intake API","version":"1.1.0","description":"Public API for querying Geo Petroleum's verified environmental compliance standards (TCEQ Title 30 TAC Chapter 334, EPA 40 CFR 280/112, ASTM E1527-21), UL-142 / UL-2085 tank manufacturing specifications, technical glossary, and submitting B2B project inquiries.","contact":{"name":"Geo Petroleum Engineering & Compliance Desk","url":"https://www.geopetroleum.com/contact","email":"info@geopetroleum.com"}},"servers":[{"url":"https://www.geopetroleum.com","description":"Production server"}],"paths":{"/api/llm":{"get":{"operationId":"queryGeoPetroleumKnowledge","summary":"Query Geo Petroleum structured entity, service, glossary, blog, and FAQ corpus","description":"Returns structured JSON covering Geo Petroleum's corporate profile, core environmental and petroleum services, technical glossary terms, engineering articles, and FAQs. Supports optional keyword search (`q`) and section filtering (`section`). No authentication required.","parameters":[{"name":"q","in":"query","required":false,"description":"Case-insensitive keyword filter matched against glossary terms, standards, blog titles/excerpts, and FAQs (e.g. 'UL 2085', 'TCEQ', 'Phase I ESA').","schema":{"type":"string","maxLength":120}},{"name":"section","in":"query","required":false,"description":"Subset of the knowledge graph to return. Defaults to 'all'.","schema":{"type":"string","enum":["all","entity","services","glossary","blogs","faqs"],"default":"all"}}],"responses":{"200":{"description":"Structured Geo Petroleum knowledge corpus response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/KnowledgeCorpusResponse"}}}},"400":{"description":"Invalid query parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}},"/api/contact":{"post":{"operationId":"submitGeoPetroleumInquiry","summary":"Submit a B2B consultation or quote request to Geo Petroleum","description":"Submits a commercial inquiry for environmental risk assessments, TCEQ/EPA compliance testing, UL-142/UL-2085 fuel tank manufacturing, or canopy imaging. Rate-limited to 3 requests per 60 seconds per client IP.","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContactInquiryRequest"}}}},"responses":{"200":{"description":"Inquiry accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmissionSuccessResponse"}}}},"400":{"description":"Validation error in submitted fields","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"429":{"description":"Rate limit exceeded (max 3 submissions per minute per IP)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}},"502":{"description":"Upstream delivery error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorResponse"}}}}}}}},"components":{"schemas":{"KnowledgeCorpusResponse":{"type":"object","required":["schemaVersion","generatedAt","resources"],"properties":{"schemaVersion":{"type":"string","example":"1.1"},"generatedAt":{"type":"string","format":"date-time"},"resources":{"type":"object","properties":{"llmsTxt":{"type":"string","format":"uri"},"llmsFullTxt":{"type":"string","format":"uri"},"openapiSpec":{"type":"string","format":"uri"},"apiDocs":{"type":"string","format":"uri"},"sitemapXml":{"type":"string","format":"uri"}}},"entity":{"type":"object"},"services":{"type":"array","items":{"type":"object","required":["id","name","url","standards","summary"],"properties":{"id":{"type":"string"},"name":{"type":"string"},"url":{"type":"string","format":"uri"},"partnerUrl":{"type":"string","format":"uri"},"standards":{"type":"array","items":{"type":"string"}},"summary":{"type":"string"}}}},"glossary":{"type":"array","items":{"type":"object"}},"articles":{"type":"array","items":{"type":"object"}},"faqs":{"type":"array","items":{"type":"object","required":["question","answer","category"],"properties":{"question":{"type":"string"},"answer":{"type":"string"},"category":{"type":"string"}}}}}},"ContactInquiryRequest":{"type":"object","required":["fullName","companyName","email","serviceNeeded","message"],"properties":{"fullName":{"type":"string","maxLength":100,"description":"Contact person's full name."},"companyName":{"type":"string","maxLength":100,"description":"Business, operator, or municipality name."},"email":{"type":"string","format":"email","maxLength":150,"description":"Valid business email address."},"phone":{"type":"string","maxLength":30,"description":"Optional callback phone number."},"serviceNeeded":{"type":"string","maxLength":120,"description":"Requested service line (e.g. 'Environmental Risk Assessment (Phase I / II ESA)', 'TCEQ / EPA Compliance & Tank Testing', 'Fuel Tank Manufacturing (UL-142 / UL-2085)', 'Canopy Imaging & LED Retrofit')."},"siteScope":{"type":"string","maxLength":120,"description":"Optional facility city/state or number of fueling sites."},"message":{"type":"string","maxLength":2000,"description":"Project scope, tank sizes, compliance deadlines, or questions."}}},"SubmissionSuccessResponse":{"type":"object","required":["ok"],"properties":{"ok":{"type":"boolean","const":true}}},"ErrorResponse":{"type":"object","required":["code","message","error","resolution"],"properties":{"code":{"type":"string","description":"Machine-readable snake_case error identifier."},"message":{"type":"string","description":"Human- and agent-readable explanation of the failure."},"error":{"type":"string","description":"Alias of message for UI form compatibility."},"resolution":{"type":"string","description":"Actionable guidance on how to fix and retry the request."}}}}}}