{"openapi":"3.1.0","info":{"title":"Omnilex Legal Sources API","version":"1.0.0","summary":"Search legislation, court decisions, circulars, doctrine, commentary, and legal documents.","description":"Programmatic access to Omnilex legal sources with filters by jurisdiction, region, source type, court, chamber, legal area, article, citation, language, dates, status, and outcome where available.","contact":{"name":"Omnilex","url":"https://www.omnilex.ai"}},"servers":[{"url":"https://api.omnilex.ai","description":"Omnilex API"}],"externalDocs":{"description":"Legal Sources API documentation","url":"https://app.omnilex.ai/en/sources/api"},"paths":{"/sources/search":{"get":{"operationId":"searchLegalSources","summary":"Search legal sources","description":"Search legislation, legislation articles, court decisions, commentary, doctrine, circulars/directives where indexed, and other legal documents. Combine free-text search with structured legal metadata filters.","parameters":[{"name":"query","in":"query","required":false,"schema":{"type":"string"},"description":"Free-text legal search query."},{"name":"jurisdiction","in":"query","required":false,"schema":{"type":"string"},"description":"Jurisdiction code such as ch, at, or de."},{"name":"region","in":"query","required":false,"schema":{"type":"string"},"description":"Region or federal/cantonal/state scope."},{"name":"language","in":"query","required":false,"schema":{"type":"string"},"description":"Language code for filtering or ranking results."},{"name":"preferredLanguage","in":"query","required":false,"schema":{"type":"string"},"description":"Language code for filtering or ranking results."},{"name":"documentType","in":"query","required":false,"schema":{"type":"string"},"description":"Document type such as act, regulation, circular, directive, or another indexed type where available."},{"name":"status","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by status."},{"name":"number","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by number."},{"name":"articleNumber","in":"query","required":false,"schema":{"type":"string"},"description":"Legislation article number."},{"name":"citation","in":"query","required":false,"schema":{"type":"string"},"description":"Legal citation or reference."},{"name":"court","in":"query","required":false,"schema":{"type":"string"},"description":"Court or chamber filter for court decisions."},{"name":"chamber","in":"query","required":false,"schema":{"type":"string"},"description":"Court or chamber filter for court decisions."},{"name":"docketNumber","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by docketNumber."},{"name":"legalArea","in":"query","required":false,"schema":{"type":"string"},"description":"Legal area classification where available."},{"name":"decisionType","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by decisionType."},{"name":"legalForce","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by legalForce."},{"name":"procedureType","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by procedureType."},{"name":"outcome","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by outcome."},{"name":"decisionDateFrom","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by decisionDateFrom."},{"name":"decisionDateTo","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by decisionDateTo."},{"name":"publicationDateFrom","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by publicationDateFrom."},{"name":"publicationDateTo","in":"query","required":false,"schema":{"type":"string"},"description":"Filter by publicationDateTo."},{"name":"sourceTypes","in":"query","required":false,"schema":{"type":"string","examples":["law,article,court_decision,commentary"]},"description":"Comma-separated source type values: law, article, court_decision, commentary."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":100,"default":20},"description":"Maximum number of results per source family."},{"name":"offset","in":"query","required":false,"schema":{"type":"integer","minimum":0,"default":0},"description":"Pagination offset."},{"name":"includeTotal","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Include total result counts when supported."}],"responses":{"200":{"description":"Grouped legal source search results.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchSourcesResponse"}}}},"400":{"description":"Invalid query parameters."},"500":{"description":"Search failed."}}}}},"components":{"schemas":{"SearchSourcesResponse":{"type":"object","properties":{"legislation":{"$ref":"#/components/schemas/SearchGroup"},"courtDecisions":{"$ref":"#/components/schemas/SearchGroup"},"commentaries":{"$ref":"#/components/schemas/SearchGroup"}},"required":["legislation","courtDecisions","commentaries"]},"SearchGroup":{"type":"object","properties":{"results":{"type":"array","items":{"$ref":"#/components/schemas/SourceSearchResult"}},"pagination":{"type":"object","properties":{"total":{"type":"integer"},"limit":{"type":"integer"},"offset":{"type":"integer"}}}}},"SourceSearchResult":{"type":"object","properties":{"id":{"type":"string"},"sourceType":{"type":"string","enum":["law","article","court_decision","commentary"]},"language":{"type":"string"},"title":{"type":["string","null"]},"summary":{"type":["string","null"]},"citation":{"type":["string","null"]},"jurisdiction":{"type":"string"},"region":{"type":"string"},"sourceUrl":{"type":["string","null"],"format":"uri"},"date":{"type":["string","null"]},"updatedAt":{"type":["string","null"]},"score":{"type":"number"}}}}}}