Lebanese Legislation Search API

The Search API from Lebanese Legislation — 1 operation(s) for search.

GitHub OpenAPI

Operations 1

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • 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.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/lebaneselegislation-com:lebaneselegislation-com-search-api"
All apis
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.

Get an API 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 Specification

lebaneselegislation-com-search-api-openapi.yml Raw ↑
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/