{"openapi":"3.1.0","info":{"title":"Omnilex Legal Sources API","version":"1.0.0","summary":"Search legislation, court decisions, circulars, doctrine, 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, official documents, and literature. Authentication is optional. Anonymous requests can search public sources, but literature results depend on the authenticated user's publication access.","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":"sourceId","in":"query","required":false,"schema":{"type":"string"},"description":"Stable source identifier."},{"name":"citation","in":"query","required":false,"schema":{"type":"string"},"description":"Legal citation or reference."},{"name":"authorName","in":"query","required":false,"schema":{"type":"string"},"description":"Issuing authority for official documents."},{"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":"authority","in":"query","required":false,"schema":{"type":"string"},"description":"Issuing authority for official documents."},{"name":"publication","in":"query","required":false,"schema":{"type":"string"},"description":"Publication title for literature."},{"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":"adoptionDateFrom","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"adoptionDateTo","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"effectiveDateFrom","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"effectiveDateTo","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"lastAmendmentDateFrom","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"lastAmendmentDateTo","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"expirationDateFrom","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"expirationDateTo","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"dateFrom","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"dateTo","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"decisionDateFrom","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"decisionDateTo","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"publicationDateFrom","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"publicationDateTo","in":"query","required":false,"schema":{"type":"string"},"description":"ISO 8601 date boundary."},{"name":"sourceTypes","in":"query","required":false,"schema":{"type":"string","examples":["law,article,court_decision,official_document,literature"]},"description":"Comma-separated source type values: law, article, court_decision, official_document, literature."},{"name":"searchMode","in":"query","required":false,"schema":{"type":"string","enum":["lexical","semantic"],"default":"lexical"},"description":"Search mode. Lexical is the default. Semantic uses vector similarity for legislation, legislation articles, court decisions."},{"name":"instance","in":"query","required":false,"schema":{"type":"integer"},"description":"Court instance number where available."},{"name":"recentlyAdded","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Limit results to recently indexed sources."},{"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"},"officialDocuments":{"$ref":"#/components/schemas/SearchGroup"},"literature":{"$ref":"#/components/schemas/SearchGroup","description":"Literature visible to the authenticated user. Anonymous requests return no restricted literature."},"meta":{"type":"object","properties":{"requestedSearchMode":{"type":"string","enum":["lexical","semantic"]},"executedSearchMode":{"type":"string","enum":["lexical","semantic"]},"fallback":{"type":"object","properties":{"from":{"type":"string","enum":["lexical","semantic"]},"to":{"type":"string","enum":["lexical","semantic"]},"reason":{"type":"string","enum":["semantic_unavailable"]}}}}}},"required":["legislation","courtDecisions","officialDocuments","literature"]},"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"}},"required":["total","limit","offset"]},"tookMs":{"type":["number","null"],"description":"Backend search duration for this source group."}},"required":["results","pagination","tookMs"]},"SourceSearchResult":{"type":"object","properties":{"id":{"type":"string"},"sourceType":{"type":"string","enum":["law","article","court_decision","official_document","literature"]},"language":{"type":"string"},"articleId":{"type":["string","null"]},"number":{"type":["string","null"]},"sourceNumber":{"type":["string","null"]},"title":{"type":["string","null"]},"titleShort":{"type":["string","null"]},"highlights":{"type":["object","null"],"additionalProperties":true},"summary":{"type":["string","null"]},"regest":{"type":["string","null"]},"content":{"type":["string","null"]},"citation":{"type":["string","null"]},"articleCitation":{"type":["string","null"]},"articleTitle":{"type":["string","null"]},"anchor":{"type":["string","null"]},"routeSlug":{"type":["string","null"]},"parentTitle":{"type":["string","null"]},"slug":{"type":["string","null"]},"description":{"type":["string","null"]},"jurisdiction":{"type":"string"},"region":{"type":"string"},"sourceUrl":{"type":["string","null"],"format":"uri"},"date":{"type":["string","null"]},"authorName":{"type":["string","null"]},"updatedAt":{"type":["string","null"]},"score":{"type":"number"}},"required":["id","sourceType","language","title","summary","citation","description","jurisdiction","region","sourceUrl","date","updatedAt","score"]}}}}