README

Légifrance for omnisense/omnilex: codes, laws, decrees and the Journal officiel through the DILA's API on PISTE - a text or one article as in force at a date, a search in the codes, the consolidated texts and the case law, the links of an article, the texts published since a date.

$legifrance = (new LegifranceSourceFactory($http))->create(['client_id' => '...', 'client_secret' => '...']);

// Article L. 36-11 of the code des postes et des communications électroniques, on 1 January 2018
$article = $legifrance->article('LEGITEXT000006070987', 'L36-11', new DateTimeImmutable('2018-01-01'));
$article->content;
$article->version->from;                     // the day that wording started to apply
$article->versions;                          // every version of the article

$legifrance->search(new Query(number: 'L36-11', kind: Kind::ARTICLE, subjects: ['Code des postes et des communications électroniques'], at: '2018-01-01'));
$legifrance->text('LEGITEXT000038359719', new DateTimeImmutable('2019-06-22'));   // a law, as consolidated that day
$legifrance->recent(new DateTimeImmutable('-7 days'), new Query(types: ['LOI', 'DECRET']));

omnilex:
    sources:
        legifrance: { factory: legifrance, options: { client_id: '%env(PISTE_CLIENT_ID)%', client_secret: '%env(PISTE_CLIENT_SECRET)%' } }

Install

composer require omnilex/legifrance

It brings the family's core, omnisense/omnilex, and omnisense/contracts with it. A PISTE account is needed (free, piste.gouv.fr), with an application subscribed to Légifrance: its OAuth client credentials (below). Without one, the tests run on recorded answers; for a first call with no account, take omnilex/eurlex or omnilex/justice-administrative.

Not verified against the real service

This package was written from the DILA's public documentation, without PISTE credentials: no call was made to the real API. The requests follow the documented examples to the letter; the reading of the answers follows the Swagger's definitions, which the documentation does not illustrate with real answers. Expect adjustments at the first real run - .samples/live.php of the workspace runs the documented cases as soon as PISTE_CLIENT_ID and PISTE_CLIENT_SECRET are set. See what is not verified.

What you need to obtain

The API is free, behind PISTE, the State's API portal.

Create an account: https://piste.gouv.fr/registration.
Accept the terms of use of the Légifrance API (menu "API" > "Consentement CGU API"), for the sandbox and for production.
In "Applications", open the application (a sandbox one is created with the account; create one for production) and tick the Légifrance API in its list of APIs.
Copy the application's OAuth credentials: Client ID and Client Secret.

Option
`client_id`, `client_secret`	the application's OAuth credentials (required)
`sandbox`	`true` with the sandbox application's credentials: `sandbox-api.piste.gouv.fr`, data that differ from production
`throttle`	seconds between two calls (0.5)
`base_uri`, `token_uri`	to override either

The data are under the Licence Ouverte 2.0; their use is subject to the terms of PISTE and of the Légifrance API, and to quotas "detailed on the PISTE portal" - not public: a quota spent comes back as a RateLimitedException.

See docs/.

Usage policy

Declared as data in policy.json (read at https://piste.gouv.fr/images/cgu/DILA_Legifrance_Beta_v2.pdf on 2026-11-10), and honoured on every request by the core: a limit reached waits when its window ends within max_wait seconds, else the request is not sent (Usage policies).

Limits: not published (unknown).
Licence: etalab-2.0; commercial use: allowed.
Credit: required: Source : Légifrance (DILA), données mises à jour le (https://www.legifrance.gouv.fr).
Needs: a key.

Responsibility

This package is an independent, unofficial client: it is not affiliated with, endorsed by or sponsored by the DILA (Légifrance) or the PISTE platform. It reaches their service on behalf of whoever runs it, and it does not redistribute their data beyond the short excerpts recorded as test fixtures. Its MIT licence covers this package's code only and grants no right to the service or to its data.

Whoever installs and runs this package is responsible for complying with the terms of PISTE and of the Légifrance API (piste.gouv.fr/cgu), for obtaining whatever they require (an account, a key, a licence or subscription, an attribution or a citation, a rate limit to respect), and for any use made of what it returns. The authors publish it free of charge, make no commercial use of it, and accept no liability for how it is used (see LICENSE).

License: MIT since 2026-10-09; earlier versions remain published under LGPL-3.0-or-later.

omnilex / legifrance

Package info

Security

Statistics