{"openapi":"3.1.0","info":{"title":"Fathers Observatory Source Graph API","version":"v1","description":"A read-only, citation-ready public source graph for Fathers Observatory briefs, dossiers, sources, money trails, and jurisdiction scopes."},"servers":[{"url":"/api/observatory/v1"}],"tags":[{"name":"Observatory","description":"Public allowlisted Observatory records for citation and downstream tools."}],"paths":{"/":{"get":{"operationId":"getObservatoryIndex","summary":"API index","description":"Returns the read-only Observatory API index and endpoint list.","tags":["Observatory"],"responses":{"200":{"description":"Returns the read-only Observatory API index and endpoint list.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ObservatoryEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ObservatoryIndex"}}}]}}}}}}},"/briefs":{"get":{"operationId":"listObservatoryBriefs","summary":"List briefs","description":"Returns public Observatory brief records.","tags":["Observatory"],"responses":{"200":{"description":"Returns public Observatory brief records.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ObservatoryEnvelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ObservatoryBrief"}}}}]}}}},"503":{"description":"Brief upstreams are temporarily unavailable; response is not cached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObservatoryErrorEnvelope"}}}}}}},"/atlas/layers":{"get":{"operationId":"listObservatoryAtlasLayers","summary":"List Atlas layers","description":"Returns registry-driven public Atlas layers with review and source policy metadata.","tags":["Observatory"],"responses":{"200":{"description":"Returns registry-driven public Atlas layers with review and source policy metadata.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ObservatoryEnvelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ObservatoryAtlasLayer"}}}}]}}}}}}},"/dossiers":{"get":{"operationId":"listObservatoryDossiers","summary":"List dossiers","description":"Returns public Observatory dossier records.","tags":["Observatory"],"responses":{"200":{"description":"Returns public Observatory dossier records.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ObservatoryEnvelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ObservatoryDossier"}}}}]}}}}}}},"/dossiers/{slug}":{"get":{"operationId":"getObservatoryDossier","summary":"Get dossier","description":"Returns one public dossier record by slug.","tags":["Observatory"],"parameters":[{"name":"slug","in":"path","required":true,"description":"Public dossier slug.","schema":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}}],"responses":{"200":{"description":"Returns one public dossier record by slug.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ObservatoryEnvelope"},{"type":"object","properties":{"data":{"$ref":"#/components/schemas/ObservatoryDossier"}}}]}}}},"404":{"description":"Observatory dossier not found.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObservatoryErrorEnvelope"}}}}}}},"/feed.json":{"get":{"operationId":"getObservatoryJsonFeed","summary":"JSON Feed","description":"Returns a JSON Feed 1.1 subscription document for public Observatory briefs and dossiers.","tags":["Observatory"],"responses":{"200":{"description":"JSON Feed subscription document for public Observatory records.","content":{"application/feed+json":{"schema":{"$ref":"#/components/schemas/ObservatoryJsonFeed"}}}}}}},"/rss.xml":{"get":{"operationId":"getObservatoryRssFeed","summary":"RSS feed","description":"Returns an RSS 2.0 subscription document for public Observatory briefs and dossiers.","tags":["Observatory"],"responses":{"200":{"description":"RSS subscription document for public Observatory records.","content":{"application/rss+xml":{"schema":{"type":"string"}}}}}}},"/money-trails":{"get":{"operationId":"listObservatoryMoneyTrails","summary":"List money trails","description":"Returns public incentive and money-trail records with guardrails.","tags":["Observatory"],"responses":{"200":{"description":"Returns public incentive and money-trail records with guardrails.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ObservatoryEnvelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ObservatoryMoneyTrail"}}}}]}}}}}}},"/sources":{"get":{"operationId":"listObservatorySources","summary":"List sources","description":"Returns public source records related to approved Observatory briefs.","tags":["Observatory"],"responses":{"200":{"description":"Returns public source records related to approved Observatory briefs.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ObservatoryEnvelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ObservatorySource"}}}}]}}}},"503":{"description":"Source upstreams are temporarily unavailable; response is not cached.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ObservatoryErrorEnvelope"}}}}}}},"/jurisdictions":{"get":{"operationId":"listObservatoryJurisdictions","summary":"List jurisdictions","description":"Returns public jurisdiction and scope records.","tags":["Observatory"],"responses":{"200":{"description":"Returns public jurisdiction and scope records.","content":{"application/json":{"schema":{"allOf":[{"$ref":"#/components/schemas/ObservatoryEnvelope"},{"type":"object","properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/ObservatoryJurisdiction"}}}}]}}}}}}},"/openapi.json":{"get":{"operationId":"getObservatoryOpenApiDocument","summary":"OpenAPI contract","description":"Returns this machine-readable OpenAPI document.","tags":["Observatory"],"responses":{"200":{"description":"OpenAPI 3.1 document for the read-only Observatory API.","content":{"application/json":{"schema":{"type":"object"}}}}}}}},"components":{"schemas":{"ObservatoryJsonFeedItem":{"type":"object","additionalProperties":false,"required":["id","url","title","summary","content_text","tags"],"properties":{"id":{"type":"string"},"url":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"content_text":{"type":"string"},"date_published":{"type":"string"},"date_modified":{"type":"string"},"tags":{"type":"array","items":{"type":"string"}}}},"ObservatoryJsonFeed":{"type":"object","additionalProperties":false,"required":["version","title","home_page_url","feed_url","items"],"properties":{"version":{"const":"https://jsonfeed.org/version/1.1"},"title":{"type":"string"},"home_page_url":{"type":"string"},"feed_url":{"type":"string"},"description":{"type":"string"},"language":{"type":"string"},"authors":{"type":"array","items":{"type":"object","properties":{"name":{"type":"string"},"url":{"type":"string"}}}},"items":{"type":"array","items":{"$ref":"#/components/schemas/ObservatoryJsonFeedItem"}}}},"ObservatoryEnvelope":{"type":"object","additionalProperties":false,"required":["success"],"properties":{"success":{"type":"boolean"},"data":{},"error":{"type":"string"},"meta":{"$ref":"#/components/schemas/ObservatoryMeta"}}},"ObservatoryErrorEnvelope":{"type":"object","additionalProperties":false,"required":["success","error"],"properties":{"success":{"const":false},"error":{"type":"string"}}},"ObservatoryMeta":{"type":"object","additionalProperties":false,"required":["total","page","limit"],"properties":{"total":{"type":"integer","minimum":0},"page":{"type":"integer","minimum":1},"limit":{"type":"integer","minimum":1},"version":{"const":"v1"},"updatedAt":{"type":"string"}}},"ObservatoryIndex":{"type":"object","additionalProperties":false,"required":["version","name","endpoints"],"properties":{"version":{"const":"v1"},"name":{"const":"Fathers Observatory API"},"endpoints":{"type":"array","items":{"type":"string"}}}},"ObservatoryConfidence":{"type":"string","enum":["verified","sourced","developing","needs_receipts","contested"]},"ObservatoryBrief":{"type":"object","additionalProperties":false,"required":["id","title","summary","href","category","railId","scopeIds","atlasHref","articleLayerHref","publishedAt","evidenceLevel","confidence","incentiveMapStatus","hasMoneyTrail","sourceCount"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"summary":{"type":"string"},"href":{"type":"string"},"category":{"type":"string"},"railId":{"anyOf":[{"type":"string"},{"type":"null"}]},"scopeIds":{"type":"array","items":{"type":"string"}},"atlasHref":{"anyOf":[{"type":"string"},{"type":"null"}]},"articleLayerHref":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"evidenceLevel":{"type":"string"},"confidence":{"type":"string"},"incentiveMapStatus":{"type":"string"},"hasMoneyTrail":{"type":"boolean"},"sourceCount":{"type":"integer","minimum":0}}},"ObservatoryDossier":{"type":"object","additionalProperties":false,"required":["id","slug","title","summary","railId","signals","receipts","openQuestions","repairPaths","atlasLayerIds","moneyTrailIds","confidence","lastReviewedAt"],"properties":{"id":{"type":"string"},"slug":{"type":"string","pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string"},"summary":{"type":"string"},"railId":{"type":"string"},"signals":{"type":"array","items":{"type":"string"}},"receipts":{"type":"array","items":{"type":"string"}},"openQuestions":{"type":"array","items":{"type":"string"}},"repairPaths":{"type":"array","items":{"type":"string"}},"atlasLayerIds":{"type":"array","items":{"type":"string"}},"moneyTrailIds":{"type":"array","items":{"type":"string"}},"confidence":{"$ref":"#/components/schemas/ObservatoryConfidence"},"lastReviewedAt":{"type":"string"}}},"ObservatoryMoneyTrail":{"type":"object","additionalProperties":false,"required":["id","railId","title","thesis","guardrail","flows","incentives","receipts","unresolved"],"properties":{"id":{"type":"string"},"railId":{"type":"string"},"title":{"type":"string"},"thesis":{"type":"string"},"guardrail":{"type":"string"},"flows":{"type":"array","items":{"type":"string"}},"incentives":{"type":"array","items":{"type":"string"}},"receipts":{"type":"array","items":{"type":"string"}},"unresolved":{"type":"array","items":{"type":"string"}}}},"ObservatoryAtlasLayer":{"type":"object","additionalProperties":false,"required":["id","label","description","status","objectTypes","scopeTypes","minimumReviewLevel","publicationStatus","sourcePolicy"],"properties":{"id":{"type":"string"},"label":{"type":"string"},"description":{"type":"string"},"status":{"type":"string"},"objectTypes":{"type":"array","items":{"type":"string"}},"scopeTypes":{"type":"array","items":{"type":"string"}},"minimumReviewLevel":{"type":"string"},"publicationStatus":{"type":"string"},"sourcePolicy":{"const":"approved_public_only"}}},"ObservatorySource":{"type":"object","additionalProperties":false,"required":["id","title","url","domain","sourceType","publisher","publishedAt","accessedAt","archiveUrl","verificationStatus","relatedBriefIds"],"properties":{"id":{"type":"string"},"title":{"type":"string"},"url":{"anyOf":[{"type":"string"},{"type":"null"}]},"domain":{"anyOf":[{"type":"string"},{"type":"null"}]},"sourceType":{"type":"string"},"publisher":{"anyOf":[{"type":"string"},{"type":"null"}]},"publishedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"accessedAt":{"anyOf":[{"type":"string"},{"type":"null"}]},"archiveUrl":{"anyOf":[{"type":"string"},{"type":"null"}]},"verificationStatus":{"type":"string"},"relatedBriefIds":{"type":"array","items":{"type":"string"}}}},"ObservatoryJurisdiction":{"type":"object","additionalProperties":false,"required":["id","scopeType","level","parentId","primaryParentId","relatedScopeIds","path","name","slug","countryCode","region","city","center","summary","confidence","lastReviewedAt","railIds","moneyTrailIds","publicationStatus","privacyRisk","reviewLevel"],"properties":{"id":{"type":"string"},"scopeType":{"type":"string"},"level":{"type":"string","pattern":"^[a-z][a-z0-9_-]*$"},"parentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"primaryParentId":{"anyOf":[{"type":"string"},{"type":"null"}]},"relatedScopeIds":{"type":"array","items":{"type":"string"}},"path":{"type":"array","items":{"type":"string"}},"name":{"type":"string"},"slug":{"type":"string"},"countryCode":{"anyOf":[{"type":"string"},{"type":"null"}]},"region":{"anyOf":[{"type":"string"},{"type":"null"}]},"city":{"anyOf":[{"type":"string"},{"type":"null"}]},"center":{"type":"array","prefixItems":[{"type":"number"},{"type":"number"}],"minItems":2,"maxItems":2},"summary":{"type":"string"},"confidence":{"$ref":"#/components/schemas/ObservatoryConfidence"},"lastReviewedAt":{"type":"string"},"railIds":{"type":"array","items":{"type":"string"}},"moneyTrailIds":{"type":"array","items":{"type":"string"}},"publicationStatus":{"type":"string"},"privacyRisk":{"type":"string"},"reviewLevel":{"type":"string"}}}}}}