{"openapi":"3.1.0","info":{"title":"Technology Library East Asia API","version":"1.0.0","summary":"Read-only English evidence base over East Asian energy technology.","description":"Versioned read-only JSON API. All data routes require an API key. Chinese, Japanese and Korean query text is resolved to English before search and the resolution is reported on every search response. Every row carries its licence and restriction labels.","license":{"name":"Proprietary study environment; per-record licences apply","identifier":"LicenseRef-TLEA-Mixed"}},"servers":[{"url":"https://tlea-api.hilir.app","description":"Direct API and MCP host"},{"url":"https://tlea.hilir.app","description":"Apex host, routed to the API for /api/*, /mcp and /health"}],"security":[{"BearerAuth":[]}],"tags":[{"name":"system","description":"Health and contract"},{"name":"search","description":"Search and query resolution"},{"name":"sources","description":"Source registry"},{"name":"documents","description":"Documents and translations"},{"name":"technologies","description":"Thin technology records"},{"name":"patents","description":"Thin patent records"},{"name":"vendors","description":"Manufacturers, suppliers and contractors"},{"name":"equipment","description":"Equipment and specifications"},{"name":"projects","description":"Projects and parties"},{"name":"standards","description":"Standards and scope texts"}],"paths":{"/health":{"get":{"tags":["system"],"summary":"Liveness and readiness","security":[],"parameters":[{"name":"deep","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"When true, also checks the database connection."}],"responses":{"200":{"description":"Service status","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Health"}}}},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/openapi.json":{"get":{"tags":["system"],"summary":"This contract","security":[],"responses":{"200":{"description":"OpenAPI 3.1 document","content":{"application/json":{"schema":{"type":"object"}}}}}}},"/api/v1/stats":{"get":{"tags":["system"],"summary":"Library counts and translation coverage","responses":{"200":{"description":"Counts by kind, licence mix and last load","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Stats"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/facets":{"get":{"tags":["search"],"summary":"Controlled values for filters","responses":{"200":{"description":"Sectors, disciplines, regions, countries, entity classes, categories, licences and statuses","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Facets"}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/search":{"get":{"tags":["search"],"summary":"Ranked search over English text and local names","description":"Accepts English, Chinese (Simplified or Traditional), Japanese or Korean query text. The response reports how the query was resolved.","parameters":[{"$ref":"#/components/parameters/Q"},{"$ref":"#/components/parameters/Lang"},{"$ref":"#/components/parameters/Kind"},{"$ref":"#/components/parameters/Sector"},{"$ref":"#/components/parameters/Discipline"},{"$ref":"#/components/parameters/Region"},{"$ref":"#/components/parameters/ReuseLevel"},{"$ref":"#/components/parameters/SearchLimit"}],"responses":{"200":{"description":"Ranked rows plus the query resolution","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResponse"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"422":{"$ref":"#/components/responses/UnprocessableEntity"},"503":{"$ref":"#/components/responses/ServiceUnavailable"}}}},"/api/v1/resolve":{"get":{"tags":["search"],"summary":"Resolve a query without searching","parameters":[{"$ref":"#/components/parameters/Q"},{"$ref":"#/components/parameters/Lang"}],"responses":{"200":{"description":"The resolution the search would use","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Resolution"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"422":{"$ref":"#/components/responses/UnprocessableEntity"}}}},"/api/v1/sources":{"get":{"tags":["sources"],"summary":"List sources","parameters":[{"name":"code","in":"query","schema":{"type":"string"}},{"$ref":"#/components/parameters/Region"},{"$ref":"#/components/parameters/ReuseLevel"},{"name":"source_class","in":"query","schema":{"$ref":"#/components/schemas/SourceClass"}},{"name":"verification","in":"query","schema":{"$ref":"#/components/schemas/Verification"}},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"Source rows","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Source"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/sources/{source_id}":{"get":{"tags":["sources"],"summary":"Source detail","parameters":[{"$ref":"#/components/parameters/SourceId"}],"responses":{"200":{"description":"Source with its documents and block reasons","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SourceDetail"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/documents":{"get":{"tags":["documents"],"summary":"List documents","parameters":[{"name":"source_id","in":"query","schema":{"type":"string"}},{"$ref":"#/components/parameters/Lang"},{"$ref":"#/components/parameters/ReuseLevel"},{"name":"translation_status","in":"query","schema":{"$ref":"#/components/schemas/TranslationStatus"}},{"$ref":"#/components/parameters/Q"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"Document metadata; no body text","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/DocumentSummary"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/documents/{slug}":{"get":{"tags":["documents"],"summary":"Document detail with English body when available","parameters":[{"$ref":"#/components/parameters/Slug"}],"responses":{"200":{"description":"Metadata, translation block and body if translated and QA-passed","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DocumentDetail"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/technologies":{"get":{"tags":["technologies"],"summary":"List technologies","parameters":[{"name":"category","in":"query","schema":{"type":"string"}},{"$ref":"#/components/parameters/Sector"},{"$ref":"#/components/parameters/Q"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"Technology rows","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Technology"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/technologies/{technology_id}":{"get":{"tags":["technologies"],"summary":"Technology detail with linked entities","parameters":[{"$ref":"#/components/parameters/TechnologyId"}],"responses":{"200":{"description":"Technology plus equipment, vendors, projects, standards and patents","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TechnologyDetail"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/patents":{"get":{"tags":["patents"],"summary":"List patents","parameters":[{"name":"jurisdiction","in":"query","schema":{"type":"string"}},{"name":"applicant","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"family_id","in":"query","schema":{"type":"string"}},{"$ref":"#/components/parameters/Sector"},{"$ref":"#/components/parameters/Q"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"Patent rows","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Patent"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/patents/{patent_id}":{"get":{"tags":["patents"],"summary":"Patent detail","parameters":[{"$ref":"#/components/parameters/PatentId"}],"responses":{"200":{"description":"Patent, applicants, sources and linked technology","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PatentDetail"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/vendors":{"get":{"tags":["vendors"],"summary":"List vendors, suppliers and contractors","parameters":[{"name":"role","in":"query","schema":{"$ref":"#/components/schemas/VendorRole"}},{"$ref":"#/components/parameters/Sector"},{"name":"country","in":"query","schema":{"type":"string","pattern":"^[A-Z]{2}$"}},{"$ref":"#/components/parameters/Q"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"Vendor rows","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Vendor"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/vendors/{vendor_id}":{"get":{"tags":["vendors"],"summary":"Vendor detail","parameters":[{"$ref":"#/components/parameters/VendorId"}],"responses":{"200":{"description":"Vendor with aliases, evidence, equipment, technologies and projects","content":{"application/json":{"schema":{"$ref":"#/components/schemas/VendorDetail"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/equipment":{"get":{"tags":["equipment"],"summary":"List equipment","parameters":[{"name":"category","in":"query","schema":{"type":"string"}},{"$ref":"#/components/parameters/Sector"},{"$ref":"#/components/parameters/Q"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"Equipment rows","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Equipment"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/equipment/{equipment_id}":{"get":{"tags":["equipment"],"summary":"Equipment detail","parameters":[{"$ref":"#/components/parameters/EquipmentId"}],"responses":{"200":{"description":"Equipment with specs, suppliers, technologies, standards and projects","content":{"application/json":{"schema":{"$ref":"#/components/schemas/EquipmentDetail"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/projects":{"get":{"tags":["projects"],"summary":"List projects","parameters":[{"name":"country","in":"query","schema":{"type":"string","pattern":"^[A-Z]{2}$"}},{"name":"status","in":"query","schema":{"type":"string"}},{"$ref":"#/components/parameters/Sector"},{"$ref":"#/components/parameters/Q"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"Project rows","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Project"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/projects/{project_id}":{"get":{"tags":["projects"],"summary":"Project detail","parameters":[{"$ref":"#/components/parameters/ProjectId"}],"responses":{"200":{"description":"Project with parties, equipment and sources","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProjectDetail"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/api/v1/standards":{"get":{"tags":["standards"],"summary":"List standards","parameters":[{"name":"issuer","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"$ref":"#/components/parameters/Q"},{"$ref":"#/components/parameters/Limit"}],"responses":{"200":{"description":"Standard rows","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Standard"}}}}},"401":{"$ref":"#/components/responses/Unauthorized"}}}},"/api/v1/standards/{standard_id}":{"get":{"tags":["standards"],"summary":"Standard detail","parameters":[{"$ref":"#/components/parameters/StandardId"}],"responses":{"200":{"description":"Standard with scope and source","content":{"application/json":{"schema":{"$ref":"#/components/schemas/StandardDetail"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"404":{"$ref":"#/components/responses/NotFound"}}}}},"components":{"securitySchemes":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT or sk- API key","description":"A hilir Access JWT (audience tlea or tlea-api) or a machine key (sk-…) with audience tlea-api and scope catalog:read."}},"parameters":{"Q":{"name":"q","in":"query","required":true,"description":"Query text in English, Chinese (Simplified or Traditional), Japanese or Korean.","schema":{"type":"string","minLength":1,"maxLength":500}},"Lang":{"name":"lang","in":"query","required":false,"description":"BCP-47 language hint. When omitted the script is detected.","schema":{"type":"string","examples":["en","zh-Hans","zh-Hant","ja","ko"]}},"Kind":{"name":"kind","in":"query","schema":{"$ref":"#/components/schemas/Kind"}},"Sector":{"name":"sector","in":"query","schema":{"type":"string","description":"Code from taxonomy.yaml."}},"Discipline":{"name":"discipline","in":"query","schema":{"type":"string","description":"Code from taxonomy.yaml."}},"Region":{"name":"region","in":"query","schema":{"type":"string","description":"Region code from taxonomy.yaml."}},"ReuseLevel":{"name":"reuse_level","in":"query","schema":{"$ref":"#/components/schemas/ReuseLevel"}},"Limit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}},"SearchLimit":{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":10}},"SourceId":{"name":"source_id","in":"path","required":true,"schema":{"type":"string"}},"Slug":{"name":"slug","in":"path","required":true,"schema":{"type":"string","description":"Stable document slug, not a repository path."}},"TechnologyId":{"name":"technology_id","in":"path","required":true,"schema":{"type":"string"}},"PatentId":{"name":"patent_id","in":"path","required":true,"schema":{"type":"string"}},"VendorId":{"name":"vendor_id","in":"path","required":true,"schema":{"type":"string"}},"EquipmentId":{"name":"equipment_id","in":"path","required":true,"schema":{"type":"string"}},"ProjectId":{"name":"project_id","in":"path","required":true,"schema":{"type":"string"}},"StandardId":{"name":"standard_id","in":"path","required":true,"schema":{"type":"string"}}},"responses":{"BadRequest":{"description":"Malformed request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"Unauthorized":{"description":"Missing or wrong API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"NotFound":{"description":"Unknown id or slug","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"UnprocessableEntity":{"description":"Invalid parameter value","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"ServiceUnavailable":{"description":"Database unreachable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"schemas":{"Error":{"type":"object","required":["error"],"properties":{"error":{"type":"string","description":"Human-readable message; no SQL or stack trace."}},"additionalProperties":false},"Health":{"type":"object","required":["status","version","database"],"properties":{"status":{"type":"string","enum":["ok","degraded"]},"version":{"type":"string"},"database":{"type":["boolean","null"],"description":"null unless deep=true."},"last_load":{"type":["string","null"],"format":"date-time"}},"additionalProperties":false},"Kind":{"type":"string","enum":["source","document","technology","patent","vendor","equipment","project","standard"]},"ReuseLevel":{"type":"string","enum":["full-text-open","full-text-restricted","summary-only","catalog-only"]},"Verification":{"type":"string","enum":["verified","unverified"]},"QualityTier":{"type":"integer","minimum":1,"maximum":3},"SourceClass":{"type":"string","enum":["government","standards-body","noc-operator","licensor","design-institute","epc-contractor","oem-manufacturer","b2b-directory","trade-media","journal","patent-office","tender-portal","company-filing","association","research-institute","service"]},"Access":{"type":"string","enum":["open","free-registration","registration","login","subscription","paywalled","mixed","unknown"]},"TranslationStatus":{"type":"string","enum":["missing","failed-qa","machine","agent-checked","human-checked","not-required"]},"VendorRole":{"type":"string","enum":["oem","manufacturer","supplier","trading","licensor","epc","construction","service","packager","rental","developer","operator","integrator"]},"Labels":{"type":"object","required":["licence","reuse_level","permitted_use","restricted","quality_tier","verification","last_verified","claim"],"properties":{"licence":{"type":"string","description":"Licence identifier, or \"mixed\" when supporting sources differ."},"reuse_level":{"$ref":"#/components/schemas/ReuseLevel"},"permitted_use":{"type":"string"},"restricted":{"type":"boolean","description":"True when reuse_level is full-text-restricted."},"quality_tier":{"$ref":"#/components/schemas/QualityTier"},"verification":{"$ref":"#/components/schemas/Verification"},"last_verified":{"type":["string","null"],"format":"date"},"claim":{"type":["boolean","null"],"description":"True when the figure is vendor-published; null when no figure is involved."}}},"EntityBase":{"allOf":[{"$ref":"#/components/schemas/Labels"},{"type":"object","required":["id","kind","name","language","translated","original_url"],"properties":{"id":{"type":"string"},"kind":{"$ref":"#/components/schemas/Kind"},"name":{"type":"string"},"name_local":{"type":["string","null"]},"name_local_lang":{"type":["string","null"]},"country":{"type":["string","null"],"pattern":"^[A-Z]{2}$"},"original_url":{"type":"string","format":"uri"},"language":{"type":"string"},"translated":{"type":"boolean"}}}]},"ResolutionTerm":{"type":"object","required":["term","en","source"],"properties":{"term":{"type":"string"},"en":{"type":"string"},"source":{"type":"string","enum":["termbase","alias","cache","mt"]}},"additionalProperties":false},"Resolution":{"type":"object","required":["query","query_lang","query_en","resolved_by","terms"],"properties":{"query":{"type":"string"},"query_lang":{"type":["string","null"]},"query_en":{"type":["string","null"]},"resolved_by":{"type":"string","enum":["alias","termbase","cache","mt","none"]},"terms":{"type":"array","items":{"$ref":"#/components/schemas/ResolutionTerm"}}},"additionalProperties":false},"TranslationBlock":{"type":"object","required":["exists","served","coverage","qa_passed"],"properties":{"exists":{"type":"boolean"},"served":{"type":"boolean"},"method":{"type":["string","null"]},"model":{"type":["string","null"]},"version":{"type":["string","null"]},"review":{"type":["string","null"]},"reviewer":{"type":["string","null"]},"coverage":{"type":["string","null"]},"qa_passed":{"type":"boolean"}},"additionalProperties":false},"Source":{"allOf":[{"$ref":"#/components/schemas/Labels"},{"type":"object","required":["id","kind","name","url","source_class","access"],"properties":{"id":{"type":"string"},"kind":{"const":"source"},"code":{"type":"string"},"name":{"type":"string"},"name_local":{"type":["string","null"]},"name_local_lang":{"type":["string","null"]},"language":{"type":"string"},"country":{"type":["string","null"]},"url":{"type":"string","format":"uri"},"source_class":{"$ref":"#/components/schemas/SourceClass"},"access":{"$ref":"#/components/schemas/Access"},"automated_access":{"type":["string","null"]},"publisher_org":{"type":["string","null"]},"update_frequency":{"type":["string","null"]},"content_formats":{"type":"array","items":{"type":"string"}},"sectors":{"type":"array","items":{"type":"string"}},"disciplines":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}},"tags":{"type":"array","items":{"type":"string"}},"identity_verified":{"type":"boolean"},"document_count":{"type":"integer","minimum":0},"notes":{"type":["string","null"]}}}]},"SourceDetail":{"allOf":[{"$ref":"#/components/schemas/Source"},{"type":"object","properties":{"documents":{"type":"array","items":{"$ref":"#/components/schemas/DocumentSummary"}},"block_reasons":{"type":"array","items":{"type":"string"}}}}]},"DocumentSummary":{"allOf":[{"$ref":"#/components/schemas/Labels"},{"type":"object","required":["id","kind","slug","title","language","translation_status","body_available"],"properties":{"id":{"type":"string"},"kind":{"const":"document"},"slug":{"type":"string"},"source_id":{"type":"string"},"title":{"type":"string"},"title_local":{"type":["string","null"]},"language":{"type":"string"},"original_url":{"type":"string","format":"uri"},"published":{"type":["string","null"],"format":"date"},"retrieved_at":{"type":"string","format":"date-time"},"translated":{"type":"boolean"},"translation_status":{"$ref":"#/components/schemas/TranslationStatus"},"body_available":{"type":"boolean"},"summary":{"type":["string","null"],"description":"Null unless translated, QA-passed and coverage is full."},"translation":{"$ref":"#/components/schemas/TranslationBlock"}}}]},"DocumentDetail":{"allOf":[{"$ref":"#/components/schemas/DocumentSummary"},{"type":"object","properties":{"sha256":{"type":"string"},"extraction":{"type":["string","null"]},"pii_stripped":{"type":"boolean"},"body":{"type":["string","null"],"description":"English body. Null when body_available is false. Restricted documents are served to authenticated callers with labels."}}}]},"Technology":{"allOf":[{"$ref":"#/components/schemas/EntityBase"},{"type":"object","required":["category"],"properties":{"kind":{"const":"technology"},"category":{"type":"string"},"sectors":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"aliases":{"type":"array","items":{"type":"string"}},"equipment_count":{"type":"integer","minimum":0},"vendor_count":{"type":"integer","minimum":0},"project_count":{"type":"integer","minimum":0},"patent_count":{"type":"integer","minimum":0}}}]},"TechnologyLink":{"type":"object","required":["kind","id","name","role"],"properties":{"kind":{"$ref":"#/components/schemas/Kind"},"id":{"type":"string"},"name":{"type":"string"},"role":{"type":["string","null"]},"source_url":{"type":["string","null"],"format":"uri"}}},"TechnologyDetail":{"allOf":[{"$ref":"#/components/schemas/Technology"},{"type":"object","properties":{"equipment":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}},"vendors":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}},"projects":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}},"standards":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}},"patents":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}}}}]},"Patent":{"allOf":[{"$ref":"#/components/schemas/EntityBase"},{"type":"object","required":["jurisdiction","publication_no","status"],"properties":{"kind":{"const":"patent"},"jurisdiction":{"type":"string"},"publication_no":{"type":"string"},"application_no":{"type":["string","null"]},"kind_code":{"type":["string","null"]},"applicants":{"type":"array","items":{"type":"string"}},"assignees":{"type":"array","items":{"type":"string"}},"filing_date":{"type":["string","null"],"format":"date"},"publication_date":{"type":["string","null"],"format":"date"},"priority_date":{"type":["string","null"],"format":"date"},"status":{"type":"string"},"family_id":{"type":["string","null"]},"ipc":{"type":"array","items":{"type":"string"}},"cpc":{"type":"array","items":{"type":"string"}},"abstract":{"type":["string","null"]},"claims_summary":{"type":["string","null"],"description":"Our summary of the claims, not the claims themselves."},"inventors":{"type":"array","items":{"type":"string"},"description":"Published bibliographic names only; contact details are stripped."}}}]},"Evidence":{"type":"object","required":["source_url","read_at"],"properties":{"source_url":{"type":"string","format":"uri"},"note":{"type":["string","null"]},"read_at":{"type":"string","format":"date"},"licence":{"type":"string"},"reuse_level":{"$ref":"#/components/schemas/ReuseLevel"},"quality_tier":{"$ref":"#/components/schemas/QualityTier"},"verification":{"$ref":"#/components/schemas/Verification"}}},"PatentDetail":{"allOf":[{"$ref":"#/components/schemas/Patent"},{"type":"object","properties":{"sources":{"type":"array","items":{"$ref":"#/components/schemas/Evidence"}},"technologies":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}}}}]},"Vendor":{"allOf":[{"$ref":"#/components/schemas/EntityBase"},{"type":"object","required":["roles"],"properties":{"kind":{"const":"vendor"},"roles":{"type":"array","items":{"$ref":"#/components/schemas/VendorRole"}},"aliases":{"type":"array","items":{"type":"string"}},"sectors":{"type":"array","items":{"type":"string"}},"website":{"type":["string","null"],"format":"uri"},"description":{"type":["string","null"]},"hq_city":{"type":["string","null"]},"products":{"type":"array","items":{"type":"string"}}}}]},"VendorDetail":{"allOf":[{"$ref":"#/components/schemas/Vendor"},{"type":"object","properties":{"evidence":{"type":"array","items":{"$ref":"#/components/schemas/Evidence"}},"equipment":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}},"technologies":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}},"projects":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}}}}]},"Equipment":{"allOf":[{"$ref":"#/components/schemas/EntityBase"},{"type":"object","required":["category"],"properties":{"kind":{"const":"equipment"},"category":{"type":"string"},"applications":{"type":"array","items":{"type":"string"}},"sectors":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"supplier_count":{"type":"integer","minimum":0}}}]},"Spec":{"type":"object","required":["metric","claim"],"properties":{"metric":{"type":"string"},"range":{"type":["string","null"]},"unit":{"type":["string","null"]},"basis":{"type":["string","null"]},"source_url":{"type":["string","null"],"format":"uri"},"claim":{"type":"boolean"}}},"EquipmentDetail":{"allOf":[{"$ref":"#/components/schemas/Equipment"},{"type":"object","properties":{"specs":{"type":"array","items":{"$ref":"#/components/schemas/Spec"}},"suppliers":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}},"technologies":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}},"standards":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}},"projects":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}}}}]},"Project":{"allOf":[{"$ref":"#/components/schemas/EntityBase"},{"type":"object","required":["status"],"properties":{"kind":{"const":"project"},"status":{"type":"string"},"capacity":{"type":["number","null"]},"capacity_unit":{"type":["string","null"]},"sectors":{"type":"array","items":{"type":"string"}},"description":{"type":["string","null"]},"site":{"type":["string","null"]},"operator":{"type":["string","null"]},"start_year":{"type":["integer","null"]}}}]},"Party":{"type":"object","required":["vendor_id","name","role"],"properties":{"vendor_id":{"type":"string"},"name":{"type":"string"},"role":{"$ref":"#/components/schemas/ProjectRole"},"scope":{"type":["string","null"]},"source_url":{"type":["string","null"],"format":"uri"}}},"ProjectDetail":{"allOf":[{"$ref":"#/components/schemas/Project"},{"type":"object","properties":{"parties":{"type":"array","items":{"$ref":"#/components/schemas/Party"}},"equipment":{"type":"array","items":{"$ref":"#/components/schemas/TechnologyLink"}},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Evidence"}}}}]},"Standard":{"allOf":[{"$ref":"#/components/schemas/EntityBase"},{"type":"object","required":["code","issuer","status"],"properties":{"kind":{"const":"standard"},"code":{"type":"string"},"title_en":{"type":["string","null"]},"issuer":{"type":"string"},"status":{"type":"string"},"scope":{"type":["string","null"]},"access":{"$ref":"#/components/schemas/Access"},"sector":{"type":["string","null"]},"replaced_by":{"type":["string","null"]}}}]},"StandardDetail":{"allOf":[{"$ref":"#/components/schemas/Standard"},{"type":"object","properties":{"sources":{"type":"array","items":{"$ref":"#/components/schemas/Evidence"}}}}]},"SearchRow":{"allOf":[{"$ref":"#/components/schemas/Labels"},{"type":"object","required":["id","kind","name","language","translated","score","matched_by"],"properties":{"id":{"type":"string"},"kind":{"$ref":"#/components/schemas/Kind"},"name":{"type":"string"},"name_local":{"type":["string","null"]},"name_local_lang":{"type":["string","null"]},"language":{"type":"string"},"translated":{"type":"boolean"},"snippet":{"type":["string","null"],"description":"Only from translated, QA-passed text."},"original_url":{"type":["string","null"],"format":"uri"},"score":{"type":"number"},"matched_by":{"type":"string","enum":["name","alias","local-name","local-title","body","translated-query"]}}}]},"SearchResponse":{"type":"object","required":["rows","resolution","total"],"properties":{"rows":{"type":"array","items":{"$ref":"#/components/schemas/SearchRow"}},"resolution":{"$ref":"#/components/schemas/Resolution"},"total":{"type":"integer","minimum":0}},"additionalProperties":false},"Stats":{"type":"object","required":["sources","documents","technologies","patents","vendors","equipment","projects","standards","translations","last_load"],"properties":{"sources":{"type":"integer","minimum":0},"documents":{"type":"integer","minimum":0},"technologies":{"type":"integer","minimum":0},"patents":{"type":"integer","minimum":0},"vendors":{"type":"integer","minimum":0},"equipment":{"type":"integer","minimum":0},"projects":{"type":"integer","minimum":0},"standards":{"type":"integer","minimum":0},"translations":{"type":"object","required":["translated","failed_qa","untranslated"],"properties":{"translated":{"type":"integer","minimum":0},"failed_qa":{"type":"integer","minimum":0},"untranslated":{"type":"integer","minimum":0}},"additionalProperties":false},"licences":{"type":"object","additionalProperties":{"type":"integer","minimum":0}},"restricted":{"type":"integer","minimum":0},"last_load":{"type":["string","null"],"format":"date-time"}},"additionalProperties":false},"Facets":{"type":"object","required":["sectors","disciplines","regions","countries","entity_classes","categories","licences","statuses"],"properties":{"sectors":{"type":"array","items":{"type":"string"}},"disciplines":{"type":"array","items":{"type":"string"}},"regions":{"type":"array","items":{"type":"string"}},"countries":{"type":"array","items":{"type":"string"}},"entity_classes":{"type":"array","items":{"type":"string"}},"categories":{"type":"array","items":{"type":"string"}},"licences":{"type":"array","items":{"type":"string"}},"statuses":{"type":"array","items":{"type":"string"}}},"additionalProperties":false},"ProjectRole":{"type":"string","enum":["owner","operator","licensor","epc","construction","supplier","integrator"]}}}}