{"openapi":"3.1.0","info":{"title":"Power cable data","version":"1.0.0"},"servers":[{"url":"https://eloragrid.ai/api/technical/v1"}],"paths":{"/cables":{"get":{"operationId":"search_cables","summary":"Find cited cable parameters by construction and size","parameters":[{"name":"q","description":"Search terms","in":"query","schema":{"type":"string","maxLength":160}},{"name":"market","description":"Market","in":"query","schema":{"type":"string","maxLength":160}},{"name":"voltage","description":"Rated voltage","in":"query","schema":{"type":"string","maxLength":160}},{"name":"conductor","description":"Conductor","in":"query","schema":{"type":"string","maxLength":160}},{"name":"size","description":"Conductor size","in":"query","schema":{"type":"string","maxLength":160}},{"name":"cores","description":"Cores","in":"query","schema":{"type":"string","maxLength":160}},{"name":"insulation","description":"Insulation","in":"query","schema":{"type":"string","maxLength":160}},{"name":"manufacturer","description":"Manufacturer","in":"query","schema":{"type":"string","maxLength":160}},{"name":"standard","description":"Standard","in":"query","schema":{"type":"string","maxLength":160}}],"responses":{"200":{"description":"Matching records in US-first order","content":{"application/json":{"schema":{"type":"object","required":["total","results"],"properties":{"total":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/Cable"}}}}}}},"307":{"description":"Email registration required for JSON downloads; crawl public cable HTML and Dataset JSON-LD without a session."},"400":{"description":"Invalid filter"}}}},"/cables/{id}":{"get":{"operationId":"get_cable","summary":"Retrieve a cable with evidence","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Cable and source","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Cable"}}}},"307":{"description":"Email registration required for JSON downloads; crawl public cable HTML and Dataset JSON-LD without a session."},"404":{"description":"Unknown cable"}}}}},"components":{"schemas":{"Cable":{"$schema":"https://json-schema.org/draft/2020-12/schema","type":"object","properties":{"id":{"type":"string"},"collection":{"type":"string","const":"cables"},"sourceId":{"type":"string"},"market":{"type":"string","enum":["US","AU"]},"manufacturer":{"type":"string"},"family":{"type":"string"},"designation":{"type":"string"},"code":{"type":"string"},"conductor":{"type":"string"},"size":{"type":"object","properties":{"value":{"anyOf":[{"type":"number","exclusiveMinimum":0},{"type":"string","pattern":"^[1-4]\\/0$"}]},"unit":{"type":"string"}},"required":["value","unit"],"additionalProperties":false},"cores":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991},"insulation":{"type":"string"},"voltage":{"type":"object","properties":{"rated":{"type":"object","properties":{"value":{"type":"number"},"unit":{"type":"string","minLength":1}},"required":["value","unit"],"additionalProperties":false},"u0":{"type":"object","properties":{"value":{"type":"number"},"unit":{"type":"string","minLength":1}},"required":["value","unit"],"additionalProperties":false},"u":{"type":"object","properties":{"value":{"type":"number"},"unit":{"type":"string","minLength":1}},"required":["value","unit"],"additionalProperties":false},"um":{"type":"object","properties":{"value":{"type":"number"},"unit":{"type":"string","minLength":1}},"required":["value","unit"],"additionalProperties":false}},"additionalProperties":false},"identityPages":{"minItems":1,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}},"standards":{"type":"array","items":{"type":"string"}},"conductorClass":{"type":"string"},"screen":{"type":"string"},"armour":{"type":"string"},"construction":{"type":"string"},"voltageMarking":{"type":"string"},"sheath":{"type":"string"},"parameters":{"type":"array","items":{"type":"object","properties":{"value":{"type":"number"},"unit":{"type":"string","minLength":1},"key":{"type":"string","enum":["dcResistance","acResistance","capacitance","reactance","ampacity","conductorShortCircuit","screenShortCircuit","diameter","weight","bendRadius","operatingTemperature","shortCircuitTemperature"]},"conditions":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{"anyOf":[{"type":"object","properties":{"value":{"type":"number"},"unit":{"type":"string","minLength":1}},"required":["value","unit"],"additionalProperties":false},{"type":"string"}]}},"pages":{"minItems":1,"type":"array","items":{"type":"integer","exclusiveMinimum":0,"maximum":9007199254740991}}},"required":["value","unit","key","conditions","pages"],"additionalProperties":false}},"source":{"type":"object","properties":{"title":{"type":"string"},"revision":{"type":"string"},"retrieved":{"type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$"},"url":{"type":"string","format":"uri"},"sha256":{"type":"string","pattern":"^[a-f0-9]{64}$"},"access":{"type":"string","enum":["publisher","hosted"]},"artifact":{"type":"object","properties":{"recordId":{"type":"string"},"fileId":{"type":"string"}},"required":["recordId","fileId"],"additionalProperties":false}},"required":["title","revision","retrieved","url","sha256","access"],"additionalProperties":false},"href":{"type":"string"},"json":{"type":"string"}},"required":["id","collection","sourceId","market","manufacturer","family","designation","code","conductor","size","cores","insulation","voltage","identityPages","standards","parameters","source","href","json"],"additionalProperties":false}}}}