{"openapi":"3.1.0","info":{"title":"Conduit API","version":"0.1.0","description":"Raw-first, derived-ready financial data infrastructure API."},"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key"},"bearerApiKey":{"type":"http","scheme":"bearer"}},"schemas":{"PaginationMeta":{"type":"object","properties":{"limit":{"type":"integer"},"cursor":{"type":["string","null"]},"next_cursor":{"type":["string","null"]},"has_more":{"type":"boolean"}}},"ListEnvelope":{"type":"object","required":["data","meta","requestId"],"properties":{"data":{"type":"array","items":{}},"meta":{"type":"object","properties":{"request_id":{"type":"string"},"requestId":{"type":"string"},"api_version":{"type":"string","const":"v1"},"pagination":{"$ref":"#/components/schemas/PaginationMeta"}}},"requestId":{"type":"string"}}},"ItemEnvelope":{"type":"object","required":["data","meta","requestId"],"properties":{"data":{"type":"object"},"meta":{"type":"object"},"requestId":{"type":"string"}}},"ErrorEnvelope":{"type":"object","required":["error","requestId"],"properties":{"error":{"type":"object","required":["code","message","request_id","requestId"],"properties":{"code":{"type":"string"},"message":{"type":"string"},"request_id":{"type":"string"},"requestId":{"type":"string"},"details":{}}},"requestId":{"type":"string"}}}},"responses":{"BadRequest":{"description":"Invalid request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"Unauthorized":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"Forbidden":{"description":"API key lacks required scope","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}},"NotFound":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorEnvelope"}}}}}},"security":[{"apiKey":[]},{"bearerApiKey":[]}],"paths":{"/health":{"get":{"summary":"Health check","security":[],"responses":{"200":{"description":"Service health"}}}},"/ready":{"get":{"summary":"Readiness check","security":[],"responses":{"200":{"description":"Service readiness"}}}},"/openapi.json":{"get":{"summary":"OpenAPI document","security":[],"responses":{"200":{"description":"OpenAPI 3.1 document"}}}},"/v1/entities":{"get":{"summary":"List entities","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Entities","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/entities/resolve":{"get":{"summary":"Resolve entity by alias","responses":{"200":{"description":"Resolved entity and matched alias","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}},"parameters":[{"name":"alias","in":"query","schema":{"type":"string"}},{"name":"alias_type","in":"query","schema":{"type":"string"}}]}},"/v1/entities/{idOrSlug}":{"get":{"summary":"Get entity","responses":{"200":{"description":"Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/entities/{idOrSlug}/aliases":{"get":{"summary":"List entity aliases","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Aliases registered for an entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/entities/{entityId}/observations":{"get":{"summary":"List entity observations","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"entity_id","in":"query","schema":{"type":"string"}},{"name":"indicator_id","in":"query","schema":{"type":"string"}},{"name":"indicatorId","in":"query","schema":{"type":"string"}},{"name":"indicator","in":"query","schema":{"type":"string"}},{"name":"source_id","in":"query","schema":{"type":"string"}},{"name":"sourceId","in":"query","schema":{"type":"string"}},{"name":"provider_id","in":"query","schema":{"type":"string"}},{"name":"providerId","in":"query","schema":{"type":"string"}},{"name":"provider","in":"query","schema":{"type":"string"}},{"name":"frequency","in":"query","schema":{"type":"string"}},{"name":"currency","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["macro"]}},{"name":"numericOnly","in":"query","schema":{"type":"boolean"}},{"name":"numeric_only","in":"query","schema":{"type":"boolean"}},{"name":"importance","in":"query","schema":{"type":"string","enum":["low","medium","high"]}},{"name":"freshness","in":"query","schema":{"type":"string","enum":["fresh","stale","unknown"]}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time lower bound on observed_at."}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time upper bound on observed_at."}},{"name":"period","in":"query","schema":{"type":"string","pattern":"^\\d{4}(-(0[1-9]|1[0-2]|[Qq][1-4]))?$","description":"Period-time convenience filter: YYYY, YYYY-MM, or YYYY-Qn."}},{"name":"period_start","in":"query","schema":{"type":"string","format":"date","description":"Period-time lower bound on period_end."}},{"name":"period_end","in":"query","schema":{"type":"string","format":"date","description":"Period-time upper bound on period_end."}},{"name":"as_of","in":"query","schema":{"type":"string","format":"date-time","description":"Knowledge-time vintage cutoff; returns latest vintage known on or before this timestamp."}}],"responses":{"200":{"description":"Entity observations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/entities/{entityId}/derived-observations":{"get":{"summary":"List entity derived observations","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"entity_id","in":"query","schema":{"type":"string"}},{"name":"derived_indicator_id","in":"query","schema":{"type":"string"}},{"name":"indicator","in":"query","schema":{"type":"string"}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"as_of","in":"query","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Entity derived observations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/countries":{"get":{"summary":"List countries","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Countries","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/countries/{idOrIso}":{"get":{"summary":"Get country","responses":{"200":{"description":"Country","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/countries/{idOrIso}/available-indicators":{"get":{"summary":"List country indicators","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Indicators available for a country","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/companies":{"get":{"summary":"List companies","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Companies","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/public/companies":{"get":{"summary":"List scored companies","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Scored fundamentals universe (S&P 500 ∪ Nasdaq-100) with sector/industry classification inline","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/companies/{idOrLookup}":{"get":{"summary":"Get company","responses":{"200":{"description":"Company","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/companies/{idOrLookup}/profile":{"get":{"summary":"Get company profile","responses":{"200":{"description":"Company profile","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/instruments":{"get":{"summary":"List instruments","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Instruments","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/instruments/{idOrLookup}":{"get":{"summary":"Get instrument","responses":{"200":{"description":"Instrument","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/indicators":{"get":{"summary":"List indicators","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Indicators","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/canonical-indicators":{"get":{"summary":"List canonical indicators","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Conduit public indicator catalog","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/indicators/{idOrSlug}":{"get":{"summary":"Get indicator","responses":{"200":{"description":"Indicator","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/indicators/{idOrSlug}/aliases":{"get":{"summary":"List indicator aliases","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Canonical, legacy, and provider-native indicator aliases","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/indicators/{idOrSlug}/series":{"get":{"summary":"List indicator series","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Provider/entity series for an indicator","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/indicators/{idOrSlug}/entities":{"get":{"summary":"List indicator entities","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Entities with observations for an indicator","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/indicators/{indicatorId}/observations":{"get":{"summary":"List indicator observations","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"entity_id","in":"query","schema":{"type":"string"}},{"name":"indicator_id","in":"query","schema":{"type":"string"}},{"name":"indicatorId","in":"query","schema":{"type":"string"}},{"name":"indicator","in":"query","schema":{"type":"string"}},{"name":"source_id","in":"query","schema":{"type":"string"}},{"name":"sourceId","in":"query","schema":{"type":"string"}},{"name":"provider_id","in":"query","schema":{"type":"string"}},{"name":"providerId","in":"query","schema":{"type":"string"}},{"name":"provider","in":"query","schema":{"type":"string"}},{"name":"frequency","in":"query","schema":{"type":"string"}},{"name":"currency","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["macro"]}},{"name":"numericOnly","in":"query","schema":{"type":"boolean"}},{"name":"numeric_only","in":"query","schema":{"type":"boolean"}},{"name":"importance","in":"query","schema":{"type":"string","enum":["low","medium","high"]}},{"name":"freshness","in":"query","schema":{"type":"string","enum":["fresh","stale","unknown"]}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time lower bound on observed_at."}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time upper bound on observed_at."}},{"name":"period","in":"query","schema":{"type":"string","pattern":"^\\d{4}(-(0[1-9]|1[0-2]|[Qq][1-4]))?$","description":"Period-time convenience filter: YYYY, YYYY-MM, or YYYY-Qn."}},{"name":"period_start","in":"query","schema":{"type":"string","format":"date","description":"Period-time lower bound on period_end."}},{"name":"period_end","in":"query","schema":{"type":"string","format":"date","description":"Period-time upper bound on period_end."}},{"name":"as_of","in":"query","schema":{"type":"string","format":"date-time","description":"Knowledge-time vintage cutoff; returns latest vintage known on or before this timestamp."}}],"responses":{"200":{"description":"Indicator observations","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/derived-indicators":{"get":{"summary":"List derived indicators","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Derived indicator definitions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/derived-indicators/{idOrSlug}":{"get":{"summary":"Get derived indicator","responses":{"200":{"description":"Derived indicator definition","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/derived-indicators/{idOrSlug}/observations":{"get":{"summary":"List derived indicator observations","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"entity_id","in":"query","schema":{"type":"string"}},{"name":"derived_indicator_id","in":"query","schema":{"type":"string"}},{"name":"indicator","in":"query","schema":{"type":"string"}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"as_of","in":"query","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Derived observations for a derived indicator","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/sources":{"get":{"summary":"List sources","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Sources","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/sources/{sourceId}":{"get":{"summary":"Get source","responses":{"200":{"description":"Source","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/providers":{"get":{"summary":"List providers","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Providers","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/providers/{providerId}":{"get":{"summary":"Get provider","responses":{"200":{"description":"Provider","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/observations":{"get":{"summary":"List observations","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"entity_id","in":"query","schema":{"type":"string"}},{"name":"indicator_id","in":"query","schema":{"type":"string"}},{"name":"indicatorId","in":"query","schema":{"type":"string"}},{"name":"indicator","in":"query","schema":{"type":"string"}},{"name":"source_id","in":"query","schema":{"type":"string"}},{"name":"sourceId","in":"query","schema":{"type":"string"}},{"name":"provider_id","in":"query","schema":{"type":"string"}},{"name":"providerId","in":"query","schema":{"type":"string"}},{"name":"provider","in":"query","schema":{"type":"string"}},{"name":"frequency","in":"query","schema":{"type":"string"}},{"name":"currency","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["macro"]}},{"name":"numericOnly","in":"query","schema":{"type":"boolean"}},{"name":"numeric_only","in":"query","schema":{"type":"boolean"}},{"name":"importance","in":"query","schema":{"type":"string","enum":["low","medium","high"]}},{"name":"freshness","in":"query","schema":{"type":"string","enum":["fresh","stale","unknown"]}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time lower bound on observed_at."}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time upper bound on observed_at."}},{"name":"period","in":"query","schema":{"type":"string","pattern":"^\\d{4}(-(0[1-9]|1[0-2]|[Qq][1-4]))?$","description":"Period-time convenience filter: YYYY, YYYY-MM, or YYYY-Qn."}},{"name":"period_start","in":"query","schema":{"type":"string","format":"date","description":"Period-time lower bound on period_end."}},{"name":"period_end","in":"query","schema":{"type":"string","format":"date","description":"Period-time upper bound on period_end."}},{"name":"as_of","in":"query","schema":{"type":"string","format":"date-time","description":"Knowledge-time vintage cutoff; returns latest vintage known on or before this timestamp."}}],"responses":{"200":{"description":"Observations with attribution, freshness, and rights metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/observations/latest":{"get":{"summary":"List latest observations","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"entity_id","in":"query","schema":{"type":"string"}},{"name":"indicator_id","in":"query","schema":{"type":"string"}},{"name":"indicatorId","in":"query","schema":{"type":"string"}},{"name":"indicator","in":"query","schema":{"type":"string"}},{"name":"source_id","in":"query","schema":{"type":"string"}},{"name":"sourceId","in":"query","schema":{"type":"string"}},{"name":"provider_id","in":"query","schema":{"type":"string"}},{"name":"providerId","in":"query","schema":{"type":"string"}},{"name":"provider","in":"query","schema":{"type":"string"}},{"name":"frequency","in":"query","schema":{"type":"string"}},{"name":"currency","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["macro"]}},{"name":"numericOnly","in":"query","schema":{"type":"boolean"}},{"name":"numeric_only","in":"query","schema":{"type":"boolean"}},{"name":"importance","in":"query","schema":{"type":"string","enum":["low","medium","high"]}},{"name":"freshness","in":"query","schema":{"type":"string","enum":["fresh","stale","unknown"]}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time lower bound on observed_at."}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time upper bound on observed_at."}},{"name":"period","in":"query","schema":{"type":"string","pattern":"^\\d{4}(-(0[1-9]|1[0-2]|[Qq][1-4]))?$","description":"Period-time convenience filter: YYYY, YYYY-MM, or YYYY-Qn."}},{"name":"period_start","in":"query","schema":{"type":"string","format":"date","description":"Period-time lower bound on period_end."}},{"name":"period_end","in":"query","schema":{"type":"string","format":"date","description":"Period-time upper bound on period_end."}},{"name":"as_of","in":"query","schema":{"type":"string","format":"date-time","description":"Knowledge-time vintage cutoff; returns latest vintage known on or before this timestamp."}}],"responses":{"200":{"description":"Latest observations by entity, indicator, source, and provider","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/observations/changes":{"get":{"summary":"List changed observations","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"entity_id","in":"query","schema":{"type":"string"}},{"name":"indicator_id","in":"query","schema":{"type":"string"}},{"name":"indicatorId","in":"query","schema":{"type":"string"}},{"name":"indicator","in":"query","schema":{"type":"string"}},{"name":"source_id","in":"query","schema":{"type":"string"}},{"name":"sourceId","in":"query","schema":{"type":"string"}},{"name":"provider_id","in":"query","schema":{"type":"string"}},{"name":"providerId","in":"query","schema":{"type":"string"}},{"name":"provider","in":"query","schema":{"type":"string"}},{"name":"frequency","in":"query","schema":{"type":"string"}},{"name":"currency","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["macro"]}},{"name":"numericOnly","in":"query","schema":{"type":"boolean"}},{"name":"numeric_only","in":"query","schema":{"type":"boolean"}},{"name":"importance","in":"query","schema":{"type":"string","enum":["low","medium","high"]}},{"name":"freshness","in":"query","schema":{"type":"string","enum":["fresh","stale","unknown"]}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time lower bound on observed_at."}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time upper bound on observed_at."}},{"name":"period","in":"query","schema":{"type":"string","pattern":"^\\d{4}(-(0[1-9]|1[0-2]|[Qq][1-4]))?$","description":"Period-time convenience filter: YYYY, YYYY-MM, or YYYY-Qn."}},{"name":"period_start","in":"query","schema":{"type":"string","format":"date","description":"Period-time lower bound on period_end."}},{"name":"period_end","in":"query","schema":{"type":"string","format":"date","description":"Period-time upper bound on period_end."}},{"name":"as_of","in":"query","schema":{"type":"string","format":"date-time","description":"Knowledge-time vintage cutoff; returns latest vintage known on or before this timestamp."}}],"responses":{"200":{"description":"Public observations changed since a timestamp","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/public/observations":{"get":{"summary":"List public observations","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"entity_id","in":"query","schema":{"type":"string"}},{"name":"indicator_id","in":"query","schema":{"type":"string"}},{"name":"indicatorId","in":"query","schema":{"type":"string"}},{"name":"indicator","in":"query","schema":{"type":"string"}},{"name":"source_id","in":"query","schema":{"type":"string"}},{"name":"sourceId","in":"query","schema":{"type":"string"}},{"name":"provider_id","in":"query","schema":{"type":"string"}},{"name":"providerId","in":"query","schema":{"type":"string"}},{"name":"provider","in":"query","schema":{"type":"string"}},{"name":"frequency","in":"query","schema":{"type":"string"}},{"name":"currency","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["macro"]}},{"name":"numericOnly","in":"query","schema":{"type":"boolean"}},{"name":"numeric_only","in":"query","schema":{"type":"boolean"}},{"name":"importance","in":"query","schema":{"type":"string","enum":["low","medium","high"]}},{"name":"freshness","in":"query","schema":{"type":"string","enum":["fresh","stale","unknown"]}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time lower bound on observed_at."}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time upper bound on observed_at."}},{"name":"period","in":"query","schema":{"type":"string","pattern":"^\\d{4}(-(0[1-9]|1[0-2]|[Qq][1-4]))?$","description":"Period-time convenience filter: YYYY, YYYY-MM, or YYYY-Qn."}},{"name":"period_start","in":"query","schema":{"type":"string","format":"date","description":"Period-time lower bound on period_end."}},{"name":"period_end","in":"query","schema":{"type":"string","format":"date","description":"Period-time upper bound on period_end."}},{"name":"as_of","in":"query","schema":{"type":"string","format":"date-time","description":"Knowledge-time vintage cutoff; returns latest vintage known on or before this timestamp."}}],"responses":{"200":{"description":"Public normalized observations using Conduit canonical indicator IDs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/public/observations/latest":{"get":{"summary":"List latest public observations","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"entity_id","in":"query","schema":{"type":"string"}},{"name":"indicator_id","in":"query","schema":{"type":"string"}},{"name":"indicatorId","in":"query","schema":{"type":"string"}},{"name":"indicator","in":"query","schema":{"type":"string"}},{"name":"source_id","in":"query","schema":{"type":"string"}},{"name":"sourceId","in":"query","schema":{"type":"string"}},{"name":"provider_id","in":"query","schema":{"type":"string"}},{"name":"providerId","in":"query","schema":{"type":"string"}},{"name":"provider","in":"query","schema":{"type":"string"}},{"name":"frequency","in":"query","schema":{"type":"string"}},{"name":"currency","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","schema":{"type":"string","enum":["macro"]}},{"name":"numericOnly","in":"query","schema":{"type":"boolean"}},{"name":"numeric_only","in":"query","schema":{"type":"boolean"}},{"name":"importance","in":"query","schema":{"type":"string","enum":["low","medium","high"]}},{"name":"freshness","in":"query","schema":{"type":"string","enum":["fresh","stale","unknown"]}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time lower bound on observed_at."}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date","description":"Knowledge-time upper bound on observed_at."}},{"name":"period","in":"query","schema":{"type":"string","pattern":"^\\d{4}(-(0[1-9]|1[0-2]|[Qq][1-4]))?$","description":"Period-time convenience filter: YYYY, YYYY-MM, or YYYY-Qn."}},{"name":"period_start","in":"query","schema":{"type":"string","format":"date","description":"Period-time lower bound on period_end."}},{"name":"period_end","in":"query","schema":{"type":"string","format":"date","description":"Period-time upper bound on period_end."}},{"name":"as_of","in":"query","schema":{"type":"string","format":"date-time","description":"Knowledge-time vintage cutoff; returns latest vintage known on or before this timestamp."}}],"responses":{"200":{"description":"Latest public normalized macro observations by canonical indicator","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/manifest":{"get":{"summary":"Get sync manifest","responses":{"200":{"description":"Sync manifest hash, latest run, freshness, and source health","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/snapshot":{"get":{"summary":"Get sync snapshot","responses":{"200":{"description":"Public observation snapshot with manifest and source health","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/source-health":{"get":{"summary":"List source health","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Public source and connector freshness summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/provenance/observations/{observationId}":{"get":{"summary":"Get observation provenance","responses":{"200":{"description":"Observation source, raw payload metadata, and ingestion evidence","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/platform/macro-data":{"get":{"summary":"List platform macro data","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Neural Edge-compatible macro rows. The forecast field carries a Conduit-generated statistical baseline (forecastMethod + prediction interval), never vendor/sell-side consensus; it targets the revised series we store, not the first print.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/events":{"get":{"summary":"List official events","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"entity_id","in":"query","schema":{"type":"string"}},{"name":"indicator_id","in":"query","schema":{"type":"string"}},{"name":"indicator","in":"query","schema":{"type":"string"}},{"name":"source_id","in":"query","schema":{"type":"string"}},{"name":"provider_id","in":"query","schema":{"type":"string"}},{"name":"event_class","in":"query","schema":{"type":"string","enum":["macro_release","central_bank","issuer_filing","issuer_disclosure","regulator_notice","corporate_action","other"]}},{"name":"event_type","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"exposure","in":"query","schema":{"type":"string"}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"as_of","in":"query","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Unified official event surface across calendars and filing-linked events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/events/{eventId}":{"get":{"summary":"Get official event","responses":{"200":{"description":"Official event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/derived-observations":{"get":{"summary":"List derived observations","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"entity_id","in":"query","schema":{"type":"string"}},{"name":"derived_indicator_id","in":"query","schema":{"type":"string"}},{"name":"indicator","in":"query","schema":{"type":"string"}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"as_of","in":"query","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Derived observations with input observation references","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/economic-calendar":{"get":{"summary":"List economic calendar events","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"country","in":"query","schema":{"type":"string"}},{"name":"entity","in":"query","schema":{"type":"string"}},{"name":"entity_id","in":"query","schema":{"type":"string"}},{"name":"indicator_id","in":"query","schema":{"type":"string"}},{"name":"indicator","in":"query","schema":{"type":"string"}},{"name":"source_id","in":"query","schema":{"type":"string"}},{"name":"provider_id","in":"query","schema":{"type":"string"}},{"name":"event_type","in":"query","schema":{"type":"string"}},{"name":"importance","in":"query","schema":{"type":"string","enum":["low","medium","high","unknown"]}},{"name":"status","in":"query","schema":{"type":"string","enum":["scheduled","released","revised","canceled","tentative"]}},{"name":"exposure","in":"query","schema":{"type":"string","enum":["public","internal_only","restricted","blocked"]}},{"name":"start_date","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"end_date","in":"query","schema":{"type":"string","format":"date-time"}},{"name":"as_of","in":"query","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"Economic calendar events with source rights metadata","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/economic-calendar/{eventId}":{"get":{"summary":"Get economic calendar event","responses":{"200":{"description":"Economic calendar event","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/ingestion-runs":{"get":{"summary":"List ingestion runs","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Ingestion run evidence","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/ingestion-jobs":{"get":{"summary":"List ingestion jobs","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Scheduled ingestion jobs","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/connector-health":{"get":{"summary":"List connector health","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Connector health state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/quality-issues":{"get":{"summary":"List quality issues","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Quality issues","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/api-usage":{"get":{"summary":"List API usage events","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"API usage events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/operational-events":{"get":{"summary":"List structured operational events","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}},{"name":"event_type","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"client_id","in":"query","schema":{"type":"string"}},{"name":"connector_id","in":"query","schema":{"type":"string"}},{"name":"source_id","in":"query","schema":{"type":"string"}},{"name":"provider_id","in":"query","schema":{"type":"string"}},{"name":"ingestion_run_id","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"Structured operational events","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/ops/summary":{"get":{"summary":"Get operations summary","responses":{"200":{"description":"Aggregate operational service state","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/ops/connectors":{"get":{"summary":"Get connector operations summary","responses":{"200":{"description":"Connector operational summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/ops/jobs":{"get":{"summary":"Get scheduler jobs operations summary","responses":{"200":{"description":"Scheduler job operational summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/ops/quality":{"get":{"summary":"Get quality operations summary","responses":{"200":{"description":"Quality operational summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/ops/usage":{"get":{"summary":"Get API usage operations summary","responses":{"200":{"description":"API usage operational summary","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/ops/alerts":{"get":{"summary":"Get alert policy evaluation","responses":{"200":{"description":"Alert policy evaluation and alert-ready event records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/ops/liveness":{"get":{"summary":"Get series liveness report","responses":{"200":{"description":"Per-series liveness and acknowledged upstream stalls","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/ops/series-candidates":{"get":{"summary":"Get series replacement candidates","responses":{"200":{"description":"Report-only replacement candidates for stalled hardcoded provider series","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/api-clients":{"get":{"summary":"List API clients","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"API clients","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/api-keys":{"get":{"summary":"List API key posture records","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"API key posture records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/raw-payloads":{"get":{"summary":"List raw payload archive records","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Raw payload archive records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/retention-policy":{"get":{"summary":"List retention policy records","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Retention policy records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/backup-manifest":{"get":{"summary":"Get backup manifest","responses":{"200":{"description":"Backup manifest","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/quarantine":{"get":{"summary":"List quarantined records","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Quarantine records","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/rate-limits":{"get":{"summary":"List rate-limit policies","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Rate-limit policies","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}},"/v1/readiness":{"get":{"summary":"Get readiness","responses":{"200":{"description":"Operational readiness","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ItemEnvelope"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"},"404":{"$ref":"#/components/responses/NotFound"}}}},"/v1/admin-sessions":{"get":{"summary":"List admin sessions","parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":500,"default":100}},{"name":"cursor","in":"query","schema":{"type":"string"}},{"name":"sort","in":"query","schema":{"type":"string"}},{"name":"order","in":"query","schema":{"type":"string","enum":["asc","desc"],"default":"asc"}}],"responses":{"200":{"description":"Admin sessions","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListEnvelope"}}}},"400":{"$ref":"#/components/responses/BadRequest"},"401":{"$ref":"#/components/responses/Unauthorized"},"403":{"$ref":"#/components/responses/Forbidden"}}}}}}