Lebanese Legislation Search API
The Search API from Lebanese Legislation — 1 operation(s) for search.
The Search API from Lebanese Legislation — 1 operation(s) for search.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/lebaneselegislation-com:lebaneselegislation-com-search-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Lebanese Legislation Search API
version: v1
summary: Read-only JSON API over every Lebanese law, decree, article, court ruling and Official Gazette issue.
description: 'Free, no key. Every text field is copied from the source as the Lebanese University''s Centre for Research and Studies in Legal Informatics published it; nothing is paraphrased. Not legal advice. updated_at is the day a record''s page last changed on the site (an amendment in force, a ruling''s reading, a correction), never the text''s own date; it is absent when not known. title_en is an unofficial English rendering of the Arabic title, written by a model; the Arabic title is official. Responses are cached for 60 seconds. Each client may make a limited number of requests a minute: on 429 wait for Retry-After.'
license:
name: MIT (code); texts keep their own rights and attribution
identifier: MIT
contact:
name: Lebanese Legislation
url: https://lebaneselegislation.com/developers/
email: nizar@taktek.io
servers:
- url: https://lebaneselegislation.com
tags:
- name: Search
paths:
/api/v1/search/:
get:
operationId: search
summary: Search laws, articles, rulings and Gazette issues by keyword or citation
description: When q finds nothing it is read again (English and French terms to Arabic, names, a year, a typo) and searched_instead says what was searched.
parameters:
- name: q
in: query
required: true
description: The words or citation to find, under 200 characters.
schema:
type: string
maxLength: 199
example: قانون العمل
- name: type
in: query
description: Search one kind only; all four when absent.
schema:
type: string
enum:
- laws
- articles
- rulings
- gazette
- name: year
in: query
description: Only texts of this year (laws).
schema:
type: integer
minimum: 0
maximum: 2100
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 50
default: 10
- $ref: '#/components/parameters/Cursor'
- name: semantic
in: query
description: true adds passages related by meaning (related), copied from the source texts.
schema:
type: boolean
default: false
- name: select
in: query
description: With semantic, keep only the related passages that answer q.
schema:
type: boolean
default: false
responses:
'200':
description: What was found.
content:
application/json:
schema:
$ref: '#/components/schemas/SearchResult'
'400':
$ref: '#/components/responses/BadRequest'
'429':
$ref: '#/components/responses/TooMany'
'503':
$ref: '#/components/responses/Busy'
tags:
- Search
components:
schemas:
Error:
type: object
required:
- error
properties:
error:
type: string
Passage:
type: object
required:
- id
- title
- text
- url
properties:
id:
type: string
title:
type: string
text:
type: string
lang:
type: string
status:
type: string
unofficial:
type: boolean
url:
type: string
format: uri
GazetteHit:
type: object
required:
- id
- url
properties:
id:
type: integer
number:
type: string
published_on:
$ref: '#/components/schemas/Date'
url:
type: string
format: uri
updated_at:
$ref: '#/components/schemas/UpdatedAt'
LawSummary:
type: object
description: A text's identity, without its text.
required:
- id
- kind
- title
- status
- article_count
- url
properties:
id:
type: integer
kind:
type: string
description: In Arabic, as the Centre names it.
kind_en:
type: string
number:
type: string
issued_on:
$ref: '#/components/schemas/Date'
title:
type: string
description: The official Arabic title.
title_en:
type: string
description: Unofficial English title, written by a model from the Arabic title.
status:
type: string
enum:
- in_force
- repealed
article_count:
type: integer
code:
type: string
description: The curated code's short name, e.g. "Code of Obligations and Contracts".
url:
type: string
format: uri
source_url:
type: string
format: uri
updated_at:
$ref: '#/components/schemas/UpdatedAt'
ArticleHit:
type: object
required:
- law
- article_number
- snippet
- url
properties:
calculated_current:
$ref: '#/components/schemas/CalculatedCurrent'
law:
$ref: '#/components/schemas/LawSummary'
article_number:
type: string
snippet:
type: string
url:
type: string
format: uri
matched_calculated_current:
type: boolean
cited:
type: boolean
description: The query cites this article, so it comes first.
UpdatedAt:
type: string
format: date
description: 'The day the record''s page last changed on the site (page_state): an amendment in force, a ruling''s reading, a correction. Never the text''s own date. Absent when not known.'
SearchResult:
type: object
required:
- q
- law_count
- article_count
- ruling_count
- gazette_count
properties:
q:
type: string
laws:
type: array
items:
$ref: '#/components/schemas/LawSummary'
law_count:
type: integer
articles:
type: array
items:
$ref: '#/components/schemas/ArticleHit'
article_count:
type: integer
rulings:
type: array
items:
$ref: '#/components/schemas/RulingHit'
ruling_count:
type: integer
gazette:
type: array
items:
$ref: '#/components/schemas/GazetteHit'
gazette_count:
type: integer
searched_instead:
type: string
searched_instead_kind:
type: string
enum:
- translated
- adjusted
related:
type: array
items:
$ref: '#/components/schemas/Passage'
semantic:
type: string
enum:
- ok
- unavailable
selection:
type: string
enum:
- ok
- unavailable
next_cursor:
type: string
description: Pass it as cursor for the next page of every kind that has more; absent on the last page. Each kind is ranked and its next page starts after its last row.
Date:
type: string
format: date
examples:
- '2026-11-02'
RulingHit:
type: object
required:
- id
- title
- url
properties:
id:
type: integer
title:
type: string
court:
type: string
decided_on:
$ref: '#/components/schemas/Date'
snippet:
type: string
url:
type: string
format: uri
pdf_url:
type: string
format: uri
description: The judgment's scan on the Lebanese University's site.
judgment_page:
type: integer
description: 'Only the machine reading matched: the page the snippet is from.'
updated_at:
$ref: '#/components/schemas/UpdatedAt'
CalculatedCurrent:
type: object
description: 'A monetary amount calculated under decree 13909/2024 (multiplier 50, effective 2024-09-19). Not published wording: cite authority.url.'
additionalProperties: true
responses:
Busy:
description: 'The server is busy: try again shortly.'
headers:
Retry-After:
schema:
type: integer
content:
text/plain:
schema:
type: string
TooMany:
description: 'Too many requests from this client: wait for Retry-After seconds.'
headers:
Retry-After:
schema:
type: integer
content:
text/plain:
schema:
type: string
BadRequest:
description: A parameter could not be read, offset was passed (removed on 6 Nov 2026), or cursor is not one this API made.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
parameters:
Cursor:
name: cursor
in: query
description: 'The next page: the next_cursor of the previous answer, unchanged. Absent on the first page. offset was removed on 6 Nov 2026 and answers 400; to jump to a period use since and until.'
schema:
type: string
externalDocs:
description: Developer guide, and the MCP server at /mcp
url: https://lebaneselegislation.com/developers/