{"openapi":"3.1.0","info":{"title":"EPC Feed API","version":"1.0.0","summary":"Read-only EPC tenders, contract awards, companies and news.","description":"Every record carries its sources with read dates. Tender status is derived from the published deadline unless the buyer reports it (see status.derived). Deadlines are given as stated and in UTC; without a zone they are read as Anywhere on Earth.","contact":{"name":"EPC Feed","url":"https://epcfeed.com/contact"}},"servers":[{"url":"https://epcfeed.com/"}],"externalDocs":{"url":"https://epcfeed.com/developers","description":"Developer guide, MCP server and feeds"},"paths":{"/api/v1/tenders":{"get":{"operationId":"listTenders","summary":"List tenders","parameters":[{"name":"status","in":"query","required":false,"description":"Tender status group.","schema":{"type":"string","enum":["open","closing-soon","closed","awarded","cancelled","suspended"]}},{"name":"country","in":"query","required":false,"description":"ISO 3166-1 alpha-2 country code.","schema":{"type":"string","pattern":"^[A-Z]{2}$"}},{"name":"sector","in":"query","required":false,"description":"Sector slug.","schema":{"type":"string"}},{"name":"notice","in":"query","required":false,"description":"Notice type.","schema":{"type":"string","enum":["general-procurement-notice","expression-of-interest","prequalification","request-for-bids","request-for-proposals","request-for-quotations","contract-notice","contract-award","cancellation"]}},{"name":"closingBefore","in":"query","required":false,"description":"Only live tenders whose deadline falls on or before this date (UTC).","schema":{"type":"string","format":"date"}},{"name":"buyer","in":"query","required":false,"description":"Company slug of the buyer.","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Items per page, 1 to 200 (default 50).","schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"offset","in":"query","required":false,"description":"Items to skip.","schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"A page of tenders","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"language":{"type":"string"},"generation":{"type":"integer"},"lastUpdated":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"docs":{"type":"string","format":"uri"},"terms":{"type":"string"}},"required":["language","generation","lastUpdated","generatedAt","docs","terms"]},{"type":"object","properties":{"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/components/schemas/TenderSummary"}}},"required":["total","limit","offset","items"],"additionalProperties":true}]}}}},"400":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/tenders/{slug}":{"get":{"operationId":"getTender","summary":"Get one tender with its full record","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"The tender","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"language":{"type":"string"},"generation":{"type":"integer"},"lastUpdated":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"docs":{"type":"string","format":"uri"},"terms":{"type":"string"}},"required":["language","generation","lastUpdated","generatedAt","docs","terms"]},{"type":"object","properties":{"item":{"$ref":"#/components/schemas/Tender"}},"required":["item"]}]}}}},"400":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/news":{"get":{"operationId":"listNews","summary":"List news stories","parameters":[{"name":"topic","in":"query","required":false,"description":"Event type.","schema":{"type":"string","enum":["contract-award","feed-award","early-works","investment-decision","tender","tender-update","financing","corporate","project-update","market-update","economic-data","technology","policy"]}},{"name":"tag","in":"query","required":false,"description":"Subject label.","schema":{"type":"string","enum":["epc","oil","natural-gas","lng","electricity","renewables","storage","nuclear","hydrogen","grid","water","transport","rail","roads","ports","aviation","construction","manufacturing","artificial-intelligence","data-centres","semiconductors","semiconductor-materials","electrical-materials","critical-minerals","copper","aluminium","lithium","nickel","cobalt","rare-earths","steel","inflation","commodity-prices","official-statistics","emissions","finance","digitalisation"]}},{"name":"company","in":"query","required":false,"description":"Company slug.","schema":{"type":"string"}},{"name":"sector","in":"query","required":false,"description":"Sector slug.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO country code.","schema":{"type":"string","pattern":"^[A-Z]{2}$"}},{"name":"eventFrom","in":"query","required":false,"description":"Inclusive earliest event date.","schema":{"type":"string","format":"date"}},{"name":"eventTo","in":"query","required":false,"description":"Inclusive latest event date.","schema":{"type":"string","format":"date"}},{"name":"q","in":"query","required":false,"description":"Words to match in the story and subject labels.","schema":{"type":"string","maxLength":100}},{"name":"sort","in":"query","required":false,"description":"Order (default newest event first).","schema":{"type":"string","enum":["newest","oldest","published"]}},{"name":"limit","in":"query","required":false,"description":"Items per page, 1 to 200 (default 50).","schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"offset","in":"query","required":false,"description":"Items to skip.","schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"A page of stories","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"language":{"type":"string"},"generation":{"type":"integer"},"lastUpdated":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"docs":{"type":"string","format":"uri"},"terms":{"type":"string"}},"required":["language","generation","lastUpdated","generatedAt","docs","terms"]},{"type":"object","properties":{"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/components/schemas/NewsSummary"}}},"required":["total","limit","offset","items"],"additionalProperties":true}]}}}},"400":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/news/{slug}":{"get":{"operationId":"getNews","summary":"Get one story with its full record","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"The story","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"language":{"type":"string"},"generation":{"type":"integer"},"lastUpdated":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"docs":{"type":"string","format":"uri"},"terms":{"type":"string"}},"required":["language","generation","lastUpdated","generatedAt","docs","terms"]},{"type":"object","properties":{"item":{"$ref":"#/components/schemas/News"}},"required":["item"]}]}}}},"400":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/companies":{"get":{"operationId":"listCompanies","summary":"List companies","parameters":[{"name":"type","in":"query","required":false,"description":"Company type.","schema":{"type":"string","enum":["epc-contractor","engineering","owner-operator","developer","utility","public-body","financier","joint-venture"]}},{"name":"sector","in":"query","required":false,"description":"Sector slug.","schema":{"type":"string"}},{"name":"country","in":"query","required":false,"description":"ISO country code of headquarters or address.","schema":{"type":"string","pattern":"^[A-Z]{2}$"}},{"name":"limit","in":"query","required":false,"description":"Items per page, 1 to 200 (default 50).","schema":{"type":"integer","minimum":1,"maximum":200}},{"name":"offset","in":"query","required":false,"description":"Items to skip.","schema":{"type":"integer","minimum":0}}],"responses":{"200":{"description":"A page of companies","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"language":{"type":"string"},"generation":{"type":"integer"},"lastUpdated":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"docs":{"type":"string","format":"uri"},"terms":{"type":"string"}},"required":["language","generation","lastUpdated","generatedAt","docs","terms"]},{"type":"object","properties":{"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/components/schemas/CompanySummary"}}},"required":["total","limit","offset","items"],"additionalProperties":true}]}}}},"400":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/companies/{slug}":{"get":{"operationId":"getCompany","summary":"Get one company with sourced facts and relationships","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"The company","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"language":{"type":"string"},"generation":{"type":"integer"},"lastUpdated":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"docs":{"type":"string","format":"uri"},"terms":{"type":"string"}},"required":["language","generation","lastUpdated","generatedAt","docs","terms"]},{"type":"object","properties":{"item":{"$ref":"#/components/schemas/Company"}},"required":["item"]}]}}}},"400":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/sectors":{"get":{"operationId":"listSectors","summary":"List sectors","responses":{"200":{"description":"Sectors","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"language":{"type":"string"},"generation":{"type":"integer"},"lastUpdated":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"docs":{"type":"string","format":"uri"},"terms":{"type":"string"}},"required":["language","generation","lastUpdated","generatedAt","docs","terms"]},{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"name":{"type":"string"},"order":{"type":"integer"},"short":{"type":"string"},"description":{"type":"string"},"glyph":{"type":"string","enum":["derrick","flame","column","turbine","sun","pylon","drop","rail","pick","molecule"]},"url":{"type":"string","format":"uri"},"tenders":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"news":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"companies":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}}},"required":["slug","name","order","short","description","glyph","url","tenders","news","companies"],"additionalProperties":false}}},"required":["items"],"additionalProperties":true}]}}}},"400":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/sectors/{slug}":{"get":{"operationId":"getSector","summary":"Get one sector","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"The sector","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"language":{"type":"string"},"generation":{"type":"integer"},"lastUpdated":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"docs":{"type":"string","format":"uri"},"terms":{"type":"string"}},"required":["language","generation","lastUpdated","generatedAt","docs","terms"]},{"type":"object","properties":{"item":{"$ref":"#/components/schemas/Sector"}},"required":["item"]}]}}}},"400":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/countries":{"get":{"operationId":"listCountries","summary":"Countries with records","responses":{"200":{"description":"Countries","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"language":{"type":"string"},"generation":{"type":"integer"},"lastUpdated":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"docs":{"type":"string","format":"uri"},"terms":{"type":"string"}},"required":["language","generation","lastUpdated","generatedAt","docs","terms"]},{"type":"object","properties":{"regions":{"type":"object","additionalProperties":{"type":"string"}},"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Z]{2}$"},"name":{"type":"string"},"region":{"type":"string"},"url":{"type":"string","format":"uri"},"tenders":{"type":"integer"},"news":{"type":"integer"},"companies":{"type":"integer"}},"required":["code","name","region","url","tenders","news","companies"],"additionalProperties":false}}},"required":["regions","items"],"additionalProperties":true}]}}}},"400":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/search":{"get":{"operationId":"search","summary":"Search tenders, companies and news","parameters":[{"name":"q","in":"query","required":true,"description":"Search words (all must match).","schema":{"type":"string","minLength":1,"maxLength":100}}],"responses":{"200":{"description":"Results by pillar","content":{"application/json":{"schema":{"allOf":[{"type":"object","properties":{"language":{"type":"string"},"generation":{"type":"integer"},"lastUpdated":{"type":"string","format":"date-time"},"generatedAt":{"type":"string","format":"date-time"},"docs":{"type":"string","format":"uri"},"terms":{"type":"string"}},"required":["language","generation","lastUpdated","generatedAt","docs","terms"]},{"type":"object","properties":{"q":{"type":"string"},"tenders":{"type":"array","items":{"$ref":"#/components/schemas/TenderSummary"}},"companies":{"type":"array","items":{"$ref":"#/components/schemas/CompanySummary"}},"news":{"type":"array","items":{"$ref":"#/components/schemas/NewsSummary"}}},"required":["q","tenders","companies","news"],"additionalProperties":true}]}}}},"400":{"description":"Invalid parameter","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Source":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"},"publisher":{"type":"string"},"publishedAt":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"accessedAt":{"type":"string","format":"date","description":"UTC calendar date on which EPC Feed read this source."},"type":{"type":"string","enum":["official-notice","company-release","exchange-filing","government","official-data","press","reference"]}},"required":["title","url","publisher","publishedAt","accessedAt","type"],"additionalProperties":false},"Correction":{"type":"object","properties":{"date":{"type":"string","format":"date"},"text":{"type":"string"}},"required":["date","text"],"additionalProperties":false},"Block":{"oneOf":[{"type":"string"},{"type":"object","properties":{"h":{"type":"string"}},"required":["h"],"additionalProperties":false},{"type":"object","properties":{"list":{"type":"array","items":{"type":"string"}}},"required":["list"],"additionalProperties":false},{"type":"object","properties":{"quote":{"type":"string"},"cite":{"type":"string"}},"required":["quote","cite"],"additionalProperties":false}]},"Money":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"}},"required":["amount","currency"],"additionalProperties":false},"Deadline":{"type":"object","properties":{"date":{"type":"string","format":"date"},"time":{"anyOf":[{"type":"string","pattern":"^([01][0-9]|2[0-3]):[0-5][0-9]$"},{"type":"null"}]},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}]},"basis":{"anyOf":[{"type":"string","enum":["stated","inferred"]},{"type":"null"}]},"note":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["date","time","timezone","basis","note"],"additionalProperties":false},"Party":{"type":"object","properties":{"name":{"type":"string"},"company":{"anyOf":[{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},{"type":"null"}]},"country":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}]}},"required":["name","company","country"],"additionalProperties":false},"CompanyRecord":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"name":{"type":"string"},"shortName":{"anyOf":[{"type":"string"},{"type":"null"}]},"legalName":{"anyOf":[{"type":"string"},{"type":"null"}]},"formerNames":{"type":"array","items":{"type":"string"}},"type":{"type":"string","enum":["epc-contractor","engineering","owner-operator","developer","utility","public-body","financier","joint-venture"]},"hq":{"type":"object","properties":{"country":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"basis":{"anyOf":[{"type":"string","enum":["headquarters","registered-office","notice-address"]},{"type":"null"}]}},"required":["country","city","basis"],"additionalProperties":false},"founded":{"anyOf":[{"type":"integer"},{"type":"null"}]},"ownership":{"type":"object","properties":{"status":{"anyOf":[{"type":"string","enum":["listed","state-owned","private","subsidiary","joint-venture","government","multilateral"]},{"type":"null"}]},"parent":{"anyOf":[{"type":"string"},{"type":"null"}]},"parentCompany":{"anyOf":[{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},{"type":"null"}]},"listings":{"type":"array","items":{"type":"object","properties":{"exchange":{"type":"string"},"ticker":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["exchange","ticker"],"additionalProperties":false}}},"required":["status","parent","parentCompany","listings"],"additionalProperties":false},"website":{"anyOf":[{"type":"string","format":"uri"},{"type":"null"}]},"sectors":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"summary":{"type":"string"},"assessment":{"anyOf":[{"type":"object","properties":{"title":{"type":"string"},"publishedAt":{"type":"string","format":"date"},"paragraphs":{"type":"array","items":{"type":"object","properties":{"text":{"type":"string"},"sources":{"type":"array","items":{"type":"integer","minimum":0},"description":"Zero-based indexes into this record’s sources array."}},"required":["text","sources"],"additionalProperties":false}}},"required":["title","publishedAt","paragraphs"],"additionalProperties":false},{"type":"null"}]},"figures":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"},"asOf":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"sources":{"type":"array","items":{"type":"integer","minimum":0},"description":"Zero-based indexes into this record’s sources array."}},"required":["label","value","asOf","sources"],"additionalProperties":false}},"projects":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"country":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}]},"role":{"type":"string"},"year":{"anyOf":[{"type":"integer"},{"type":"null"}]},"status":{"anyOf":[{"type":"string","enum":["planned","awarded","under-construction","completed","cancelled"]},{"type":"null"}]},"sources":{"type":"array","items":{"type":"integer","minimum":0},"description":"Zero-based indexes into this record’s sources array."}},"required":["name","country","role","year","status","sources"],"additionalProperties":false}},"factSources":{"type":"object","properties":{"hq":{"type":"array","items":{"type":"integer","minimum":0},"description":"Zero-based indexes into this record’s sources array."},"founded":{"type":"array","items":{"type":"integer","minimum":0},"description":"Zero-based indexes into this record’s sources array."},"ownership":{"type":"array","items":{"type":"integer","minimum":0},"description":"Zero-based indexes into this record’s sources array."},"website":{"type":"array","items":{"type":"integer","minimum":0},"description":"Zero-based indexes into this record’s sources array."},"type":{"type":"array","items":{"type":"integer","minimum":0},"description":"Zero-based indexes into this record’s sources array."}},"required":[],"additionalProperties":false},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"corrections":{"type":"array","items":{"$ref":"#/components/schemas/Correction"}}},"required":["slug","name","shortName","legalName","formerNames","type","hq","founded","ownership","website","sectors","summary","assessment","figures","projects","factSources","sources","corrections"],"additionalProperties":false},"TenderRecord":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"title":{"type":"string"},"originalTitle":{"anyOf":[{"type":"string"},{"type":"null"}]},"issuer":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"country":{"type":"string","pattern":"^[A-Z]{2}$"},"location":{"anyOf":[{"type":"string"},{"type":"null"}]},"sectors":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"reference":{"anyOf":[{"type":"string"},{"type":"null"}]},"noticeType":{"type":"string","enum":["general-procurement-notice","expression-of-interest","prequalification","request-for-bids","request-for-proposals","request-for-quotations","contract-notice","contract-award","cancellation"]},"procedure":{"anyOf":[{"type":"string"},{"type":"null"}]},"contractModel":{"anyOf":[{"type":"string","enum":["epc","epci","epcm","design-build","design-build-operate","plant-dsi","supply-install","turnkey","construction","engineering","feed"]},{"type":"null"}]},"platform":{"type":"object","properties":{"name":{"type":"string"},"id":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","id"],"additionalProperties":false},"officialUrl":{"type":"string","format":"uri"},"publishedAt":{"type":"string","format":"date"},"deadline":{"anyOf":[{"$ref":"#/components/schemas/Deadline"},{"type":"null"}]},"deadlineHistory":{"type":"array","items":{"$ref":"#/components/schemas/Deadline"}},"issuerStatus":{"anyOf":[{"type":"string","enum":["open","closed","awarded","cancelled","suspended"]},{"type":"null"}]},"statusCheckedAt":{"type":"string","format":"date"},"values":{"type":"array","items":{"type":"object","properties":{"amount":{"type":"number"},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"basis":{"type":"string","enum":["estimated","budget","contract","bid-security","evaluated-bid","financing","company-range","disclosed"]},"note":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["amount","currency","basis","note"],"additionalProperties":false}},"funding":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"funder":{"anyOf":[{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},{"type":"null"}]},"reference":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","funder","reference"],"additionalProperties":false}},"lots":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}},"required":["id","title"],"additionalProperties":false}},"scope":{"type":"string"},"documents":{"type":"array","items":{"type":"object","properties":{"title":{"type":"string"},"url":{"type":"string","format":"uri"},"type":{"type":"string","enum":["notice","bidding-documents","addendum","clarification","award","portal","other"]}},"required":["title","url","type"],"additionalProperties":false}},"award":{"anyOf":[{"type":"object","properties":{"notifiedOn":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"publishedOn":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}]},"duration":{"anyOf":[{"type":"string"},{"type":"null"}]},"winners":{"type":"array","items":{"$ref":"#/components/schemas/Party"}},"contractValues":{"type":"array","items":{"$ref":"#/components/schemas/Money"}},"bidders":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"company":{"anyOf":[{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},{"type":"null"}]},"country":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}]},"evaluatedPrice":{"anyOf":[{"$ref":"#/components/schemas/Money"},{"type":"null"}]},"outcome":{"type":"string","enum":["awarded","evaluated","rejected"]},"reason":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["name","company","country","evaluatedPrice","outcome","reason"],"additionalProperties":false}}},"required":["notifiedOn","publishedOn","duration","winners","contractValues","bidders"],"additionalProperties":false},{"type":"null"}]},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"corrections":{"type":"array","items":{"$ref":"#/components/schemas/Correction"}}},"required":["slug","title","originalTitle","issuer","country","location","sectors","reference","noticeType","procedure","contractModel","platform","officialUrl","publishedAt","deadline","deadlineHistory","issuerStatus","statusCheckedAt","values","funding","lots","scope","documents","award","sources","corrections"],"additionalProperties":false},"NewsRecord":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"title":{"type":"string"},"dek":{"type":"string"},"eventDate":{"type":"string","format":"date"},"topic":{"type":"string","enum":["contract-award","feed-award","early-works","investment-decision","tender","tender-update","financing","corporate","project-update","market-update","economic-data","technology","policy"]},"body":{"type":"array","items":{"$ref":"#/components/schemas/Block"}},"keyFacts":{"type":"array","items":{"type":"object","properties":{"label":{"type":"string"},"value":{"type":"string"}},"required":["label","value"],"additionalProperties":false}},"companies":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"tenders":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"sectors":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"countries":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"tags":{"type":"array","items":{"type":"string","enum":["epc","oil","natural-gas","lng","electricity","renewables","storage","nuclear","hydrogen","grid","water","transport","rail","roads","ports","aviation","construction","manufacturing","artificial-intelligence","data-centres","semiconductors","semiconductor-materials","electrical-materials","critical-minerals","copper","aluminium","lithium","nickel","cobalt","rare-earths","steel","inflation","commodity-prices","official-statistics","emissions","finance","digitalisation"]}},"value":{"anyOf":[{"type":"object","properties":{"amount":{"anyOf":[{"type":"number"},{"type":"null"}]},"min":{"anyOf":[{"type":"number"},{"type":"null"}]},"max":{"anyOf":[{"type":"number"},{"type":"null"}]},"currency":{"type":"string","pattern":"^[A-Z]{3}$"},"basis":{"type":"string","enum":["disclosed","company-range","reported"]},"note":{"anyOf":[{"type":"string"},{"type":"null"}]}},"required":["amount","min","max","currency","basis","note"],"additionalProperties":false},{"type":"null"}]},"image":{"anyOf":[{"type":"object","properties":{"src":{"type":"string","format":"uri-reference"},"alt":{"type":"string"},"credit":{"type":"string"},"licence":{"type":"string"}},"required":["src","alt","credit","licence"],"additionalProperties":false},{"type":"null"}]},"featured":{"type":"boolean"},"sources":{"type":"array","items":{"$ref":"#/components/schemas/Source"}},"corrections":{"type":"array","items":{"$ref":"#/components/schemas/Correction"}}},"required":["slug","title","dek","eventDate","topic","body","keyFacts","companies","tenders","sectors","countries","tags","value","image","featured","sources","corrections"],"additionalProperties":false},"SectorRecord":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"name":{"type":"string"},"order":{"type":"integer"},"short":{"type":"string"},"description":{"type":"string"},"glyph":{"type":"string","enum":["derrick","flame","column","turbine","sun","pylon","drop","rail","pick","molecule"]}},"required":["slug","name","order","short","description","glyph"],"additionalProperties":false},"TenderSummary":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"language":{"type":"string","description":"Language of the record content, including en for an English fallback."},"url":{"type":"string","format":"uri"},"markdown":{"type":"string","format":"uri"},"firstPublishedAt":{"type":"string","format":"date-time","description":"First publication on EPC Feed, assigned once by the database."},"updatedAt":{"type":"string","format":"date-time"},"revision":{"type":"integer","minimum":1},"title":{"type":"string"},"status":{"type":"object","properties":{"state":{"type":"string","enum":["open","closing-soon","closed","awarded","cancelled","suspended","reported-closed","unknown"]},"label":{"type":"string"},"derived":{"type":"boolean","description":"True for deadline-derived open, closing-soon or closed; false for a buyer-reported status or unknown."},"note":{"type":"string"},"issuerReported":{"anyOf":[{"type":"string","enum":["open","closed","awarded","cancelled","suspended"]},{"type":"null"}]},"checkedAt":{"type":"string","format":"date"}},"required":["state","label","derived","note","issuerReported","checkedAt"],"additionalProperties":false},"deadline":{"anyOf":[{"type":"object","properties":{"asStated":{"$ref":"#/components/schemas/Deadline"},"utc":{"type":"string","format":"date-time"},"zone":{"type":"string"},"anywhereOnEarth":{"type":"boolean"}},"required":["asStated","utc","zone","anywhereOnEarth"],"additionalProperties":false},{"type":"null"}]},"buyer":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"type":"string","format":"uri"}},"required":["slug","name","url"],"additionalProperties":false},"country":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Z]{2}$"},"name":{"type":"string"}},"required":["code","name"],"additionalProperties":false},"sectors":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"noticeType":{"type":"string","enum":["general-procurement-notice","expression-of-interest","prequalification","request-for-bids","request-for-proposals","request-for-quotations","contract-notice","contract-award","cancellation"]},"reference":{"anyOf":[{"type":"string"},{"type":"null"}]},"officialUrl":{"type":"string","format":"uri"}},"required":["slug","language","url","markdown","firstPublishedAt","updatedAt","revision","title","status","deadline","buyer","country","sectors","noticeType","reference","officialUrl"],"additionalProperties":false},"CompanySummary":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"language":{"type":"string","description":"Language of the record content, including en for an English fallback."},"url":{"type":"string","format":"uri"},"markdown":{"type":"string","format":"uri"},"firstPublishedAt":{"type":"string","format":"date-time","description":"First publication on EPC Feed, assigned once by the database."},"updatedAt":{"type":"string","format":"date-time"},"revision":{"type":"integer","minimum":1},"name":{"type":"string"},"type":{"type":"string","enum":["epc-contractor","engineering","owner-operator","developer","utility","public-body","financier","joint-venture"]},"country":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}]},"sectors":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"tenders":{"type":"object","properties":{"issuer":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"winner":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"bidder":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"funder":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}}},"required":["issuer","winner","bidder","funder"],"additionalProperties":false},"news":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}}},"required":["slug","language","url","markdown","firstPublishedAt","updatedAt","revision","name","type","country","sectors","tenders","news"],"additionalProperties":false},"NewsSummary":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"language":{"type":"string","description":"Language of the record content, including en for an English fallback."},"url":{"type":"string","format":"uri"},"markdown":{"type":"string","format":"uri"},"firstPublishedAt":{"type":"string","format":"date-time","description":"First publication on EPC Feed, assigned once by the database."},"updatedAt":{"type":"string","format":"date-time"},"revision":{"type":"integer","minimum":1},"title":{"type":"string"},"dek":{"type":"string"},"topic":{"type":"string","enum":["contract-award","feed-award","early-works","investment-decision","tender","tender-update","financing","corporate","project-update","market-update","economic-data","technology","policy"]},"tags":{"type":"array","items":{"type":"string","enum":["epc","oil","natural-gas","lng","electricity","renewables","storage","nuclear","hydrogen","grid","water","transport","rail","roads","ports","aviation","construction","manufacturing","artificial-intelligence","data-centres","semiconductors","semiconductor-materials","electrical-materials","critical-minerals","copper","aluminium","lithium","nickel","cobalt","rare-earths","steel","inflation","commodity-prices","official-statistics","emissions","finance","digitalisation"]}},"eventDate":{"type":"string","format":"date","description":"Date of the event, distinct from firstPublishedAt."},"companies":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"tenders":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"sectors":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"countries":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}}},"required":["slug","language","url","markdown","firstPublishedAt","updatedAt","revision","title","dek","topic","tags","eventDate","companies","tenders","sectors","countries"],"additionalProperties":false},"Tender":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"language":{"type":"string","description":"Language of the record content, including en for an English fallback."},"url":{"type":"string","format":"uri"},"markdown":{"type":"string","format":"uri"},"firstPublishedAt":{"type":"string","format":"date-time","description":"First publication on EPC Feed, assigned once by the database."},"updatedAt":{"type":"string","format":"date-time"},"revision":{"type":"integer","minimum":1},"title":{"type":"string"},"status":{"type":"object","properties":{"state":{"type":"string","enum":["open","closing-soon","closed","awarded","cancelled","suspended","reported-closed","unknown"]},"label":{"type":"string"},"derived":{"type":"boolean","description":"True for deadline-derived open, closing-soon or closed; false for a buyer-reported status or unknown."},"note":{"type":"string"},"issuerReported":{"anyOf":[{"type":"string","enum":["open","closed","awarded","cancelled","suspended"]},{"type":"null"}]},"checkedAt":{"type":"string","format":"date"}},"required":["state","label","derived","note","issuerReported","checkedAt"],"additionalProperties":false},"deadline":{"anyOf":[{"type":"object","properties":{"asStated":{"$ref":"#/components/schemas/Deadline"},"utc":{"type":"string","format":"date-time"},"zone":{"type":"string"},"anywhereOnEarth":{"type":"boolean"}},"required":["asStated","utc","zone","anywhereOnEarth"],"additionalProperties":false},{"type":"null"}]},"buyer":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"name":{"anyOf":[{"type":"string"},{"type":"null"}]},"url":{"type":"string","format":"uri"}},"required":["slug","name","url"],"additionalProperties":false},"country":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Z]{2}$"},"name":{"type":"string"}},"required":["code","name"],"additionalProperties":false},"sectors":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"noticeType":{"type":"string","enum":["general-procurement-notice","expression-of-interest","prequalification","request-for-bids","request-for-proposals","request-for-quotations","contract-notice","contract-award","cancellation"]},"reference":{"anyOf":[{"type":"string"},{"type":"null"}]},"officialUrl":{"type":"string","format":"uri"},"record":{"$ref":"#/components/schemas/TenderRecord"}},"required":["slug","language","url","markdown","firstPublishedAt","updatedAt","revision","title","status","deadline","buyer","country","sectors","noticeType","reference","officialUrl","record"],"additionalProperties":false},"Company":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"language":{"type":"string","description":"Language of the record content, including en for an English fallback."},"url":{"type":"string","format":"uri"},"markdown":{"type":"string","format":"uri"},"firstPublishedAt":{"type":"string","format":"date-time","description":"First publication on EPC Feed, assigned once by the database."},"updatedAt":{"type":"string","format":"date-time"},"revision":{"type":"integer","minimum":1},"name":{"type":"string"},"type":{"type":"string","enum":["epc-contractor","engineering","owner-operator","developer","utility","public-body","financier","joint-venture"]},"country":{"anyOf":[{"type":"string","pattern":"^[A-Z]{2}$"},{"type":"null"}]},"sectors":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"tenders":{"type":"object","properties":{"issuer":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"winner":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"bidder":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"funder":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}}},"required":["issuer","winner","bidder","funder"],"additionalProperties":false},"news":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"record":{"$ref":"#/components/schemas/CompanyRecord"},"relationships":{"type":"array","items":{"type":"object","properties":{"company":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"kind":{"type":"string","enum":["client","joint-venture","competitor","financier","parent","co-mention"]},"via":{"type":"array","items":{"type":"string"}}},"required":["company","kind","via"],"additionalProperties":false}}},"required":["slug","language","url","markdown","firstPublishedAt","updatedAt","revision","name","type","country","sectors","tenders","news","record","relationships"],"additionalProperties":false},"News":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"language":{"type":"string","description":"Language of the record content, including en for an English fallback."},"url":{"type":"string","format":"uri"},"markdown":{"type":"string","format":"uri"},"firstPublishedAt":{"type":"string","format":"date-time","description":"First publication on EPC Feed, assigned once by the database."},"updatedAt":{"type":"string","format":"date-time"},"revision":{"type":"integer","minimum":1},"title":{"type":"string"},"dek":{"type":"string"},"topic":{"type":"string","enum":["contract-award","feed-award","early-works","investment-decision","tender","tender-update","financing","corporate","project-update","market-update","economic-data","technology","policy"]},"tags":{"type":"array","items":{"type":"string","enum":["epc","oil","natural-gas","lng","electricity","renewables","storage","nuclear","hydrogen","grid","water","transport","rail","roads","ports","aviation","construction","manufacturing","artificial-intelligence","data-centres","semiconductors","semiconductor-materials","electrical-materials","critical-minerals","copper","aluminium","lithium","nickel","cobalt","rare-earths","steel","inflation","commodity-prices","official-statistics","emissions","finance","digitalisation"]}},"eventDate":{"type":"string","format":"date","description":"Date of the event, distinct from firstPublishedAt."},"companies":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"tenders":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"sectors":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"countries":{"type":"array","items":{"type":"string","pattern":"^[A-Z]{2}$"}},"record":{"$ref":"#/components/schemas/NewsRecord"}},"required":["slug","language","url","markdown","firstPublishedAt","updatedAt","revision","title","dek","topic","tags","eventDate","companies","tenders","sectors","countries","record"],"additionalProperties":false},"TenderPage":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/components/schemas/TenderSummary"}}},"required":["total","limit","offset","items"],"additionalProperties":false},"CompanyPage":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/components/schemas/CompanySummary"}}},"required":["total","limit","offset","items"],"additionalProperties":false},"NewsPage":{"type":"object","properties":{"total":{"type":"integer","minimum":0},"limit":{"type":"integer","minimum":1,"maximum":200},"offset":{"type":"integer","minimum":0},"items":{"type":"array","items":{"$ref":"#/components/schemas/NewsSummary"}}},"required":["total","limit","offset","items"],"additionalProperties":false},"Search":{"type":"object","properties":{"query":{"type":"string"},"tenders":{"type":"array","items":{"$ref":"#/components/schemas/TenderSummary"}},"companies":{"type":"array","items":{"$ref":"#/components/schemas/CompanySummary"}},"news":{"type":"array","items":{"$ref":"#/components/schemas/NewsSummary"}}},"required":["query","tenders","companies","news"],"additionalProperties":false},"Sectors":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"name":{"type":"string"},"description":{"type":"string"},"url":{"type":"string","format":"uri"},"tenders":{"type":"integer"},"news":{"type":"integer"},"companies":{"type":"integer"}},"required":["slug","name","description","url","tenders","news","companies"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false},"Sector":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"name":{"type":"string"},"order":{"type":"integer"},"short":{"type":"string"},"description":{"type":"string"},"glyph":{"type":"string","enum":["derrick","flame","column","turbine","sun","pylon","drop","rail","pick","molecule"]},"url":{"type":"string","format":"uri"}},"required":["slug","name","order","short","description","glyph","url"],"additionalProperties":false},"SectorList":{"type":"object","properties":{"items":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120},"name":{"type":"string"},"order":{"type":"integer"},"short":{"type":"string"},"description":{"type":"string"},"glyph":{"type":"string","enum":["derrick","flame","column","turbine","sun","pylon","drop","rail","pick","molecule"]},"url":{"type":"string","format":"uri"},"tenders":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"news":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}},"companies":{"type":"array","items":{"type":"string","pattern":"^[a-z0-9]+(-[a-z0-9]+)*$","maxLength":120}}},"required":["slug","name","order","short","description","glyph","url","tenders","news","companies"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false},"CountryList":{"type":"object","properties":{"regions":{"type":"object","additionalProperties":{"type":"string"}},"items":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string","pattern":"^[A-Z]{2}$"},"name":{"type":"string"},"region":{"type":"string"},"url":{"type":"string","format":"uri"},"tenders":{"type":"integer"},"news":{"type":"integer"},"companies":{"type":"integer"}},"required":["code","name","region","url","tenders","news","companies"],"additionalProperties":false}}},"required":["regions","items"],"additionalProperties":false},"ApiSearch":{"type":"object","properties":{"q":{"type":"string"},"tenders":{"type":"array","items":{"$ref":"#/components/schemas/TenderSummary"}},"companies":{"type":"array","items":{"$ref":"#/components/schemas/CompanySummary"}},"news":{"type":"array","items":{"$ref":"#/components/schemas/NewsSummary"}}},"required":["q","tenders","companies","news"],"additionalProperties":false},"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"status":{"type":"integer"},"message":{"type":"string"}},"required":["status","message"]}},"required":["error"]}}}}