# Points de terminaison d’API REST pour les licences

Utilisez l'API REST pour récupérer les licences de open source populaires et les informations sur le fichier de licence d'un projet particulier.

## À propos des licences

GitHub utilise [l'outil open source Ruby Gem Licensee](https://github.com/benbalter/licensee) pour tenter d’identifier la licence d’un projet. Le licensee fait correspondre le contenu du fichier `LICENSE` d’un projet (s’il existe) à une courte liste de licences connues. Par conséquent, l’API ne prend pas en compte les licences des dépendances de projet ou d’autres moyens de documenter la licence d’un projet, comme les références au nom de la licence dans la documentation.

Si une licence est correspondante, la clé de licence et le nom retournés sont conformes à la [spécification SPDX](https://spdx.org/).

**Remarque :** Ces points de terminaison retournent également les informations de licence d’un référentiel :

* [Obtenir un dépôt](/fr/enterprise-server@3.21/rest/repos/repos#get-a-repository)
* [Lister les dépôts d’un utilisateur](/fr/enterprise-server@3.21/rest/repos/repos#list-repositories-for-a-user)
* [Lister les dépôts d’une organisation](/fr/enterprise-server@3.21/rest/repos/repos#list-organization-repositories)
* [Lister les forks](/fr/enterprise-server@3.21/rest/repos/forks#list-forks)
* [Lister les dépôts placés en surveillance par un utilisateur](/fr/enterprise-server@3.21/rest/activity/watching#list-repositories-watched-by-a-user)
* [Lister les dépôts d’équipe](/fr/enterprise-server@3.21/rest/teams/teams#list-team-repositories)

> \[!WARNING]
> GitHub est beaucoup de choses, mais ce n’est pas un cabinet d’avocats. Par conséquent, GitHub ne fournit pas de conseils juridiques. L’utilisation de l’API ou l’envoi d’un e-mail à son sujet ne constitue pas un conseil juridique ni ne crée de relation avocat-client. Si vous avez des questions sur ce que vous pouvez et ne pouvez pas faire avec une licence particulière, vous devez consulter votre propre avocat avant de continuer. En fait, vous devez toujours consulter votre propre avocat avant de prendre des décisions susceptibles d’avoir des conséquences juridiques ou qui peuvent avoir un impact sur vos droits juridiques.
>
> GitHub a créé ces points de terminaison pour aider les utilisateurs à obtenir des informations sur les licences open source et les projets qui les utilisent. Nous espérons que cela vous aidera, mais gardez à l’esprit que nous ne sommes pas des avocats (du moins la plupart d’entre nous) et que nous faisons des erreurs comme tout le monde. Pour cette raison, GitHub fournit l’API « en l’état » et n’offre aucune garantie concernant les informations fournies sur celle-ci ou les licences fournies par l’intermédiaire de celle-ci, et exclut la responsabilité pour tous dommages résultant de l’utilisation de l’API.

> \[!NOTE]
> Most endpoints use `Authorization: Bearer <YOUR-TOKEN>` and `Accept: application/vnd.github+json` headers, plus `X-GitHub-Api-Version: 2026-03-10`. Curl examples below omit these standard headers for brevity.

## Get all commonly used licenses

```
GET /licenses
```

Lists the most commonly used licenses on GitHub. For more information, see "Licensing a repository ."

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`featured`** (boolean)

* **`per_page`** (integer)
  The number of results per page (max 100). For more information, see "Using pagination in the REST API."
  Default: `30`

* **`page`** (integer)
  The page number of the results to fetch. For more information, see "Using pagination in the REST API."
  Default: `1`

### HTTP response status codes

* **200** - OK

* **304** - Not modified

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/licenses
```

**Response schema (Status: 200):**

Array of `License Simple`:

* `key`: required, string
* `name`: required, string
* `url`: required, string or null, format: uri
* `spdx_id`: required, string or null
* `node_id`: required, string
* `html_url`: string, format: uri

## Get a license

```
GET /licenses/{license}
```

Gets information about a specific license. For more information, see "Licensing a repository ."

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`license`** (string) (required)

### HTTP response status codes

* **200** - OK

* **304** - Not modified

* **403** - Forbidden

* **404** - Resource not found

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/licenses/LICENSE
```

**Response schema (Status: 200):**

* `key`: required, string
* `name`: required, string
* `spdx_id`: required, string or null
* `url`: required, string or null, format: uri
* `node_id`: required, string
* `html_url`: required, string, format: uri
* `description`: required, string
* `implementation`: required, string
* `permissions`: required, array of string
* `conditions`: required, array of string
* `limitations`: required, array of string
* `body`: required, string
* `featured`: required, boolean

## Get the license for a repository

```
GET /repos/{owner}/{repo}/license
```

This method returns the contents of the repository's license file, if one is detected.
This endpoint supports the following custom media types. For more information, see "Media types."

application/vnd.github.raw+json: Returns the raw contents of the license.
application/vnd.github.html+json: Returns the license contents in HTML. Markup languages are rendered to HTML using GitHub's open-source Markup library.

### Parameters

#### Headers

* **`accept`** (string)
  Setting to `application/vnd.github+json` is recommended.

#### Path and query parameters

* **`owner`** (string) (required)
  The account owner of the repository. The name is not case sensitive.

* **`repo`** (string) (required)
  The name of the repository without the .git extension. The name is not case sensitive.

* **`ref`** (string)
  The Git reference for the results you want to list. The ref for a branch can be formatted either as refs/heads/<branch name> or simply <branch name>. To reference a pull request use refs/pull/<number>/merge.

### HTTP response status codes

* **200** - OK

* **404** - Resource not found

### Code examples

#### Example

**Request:**

```curl
curl -L \
  -X GET \
  http(s)://HOSTNAME/api/v3/repos/OWNER/REPO/license
```

**Response schema (Status: 200):**

* `name`: required, string
* `path`: required, string
* `sha`: required, string
* `size`: required, integer
* `url`: required, string, format: uri
* `html_url`: required, string or null, format: uri
* `git_url`: required, string or null, format: uri
* `download_url`: required, string or null, format: uri
* `type`: required, string
* `content`: required, string
* `encoding`: required, string
* `_links`: required, object:
  * `git`: required, string or null, format: uri
  * `html`: required, string or null, format: uri
  * `self`: required, string, format: uri
* `license`: required, any of:
  * **null**
  * **License Simple**
    * `key`: required, string
    * `name`: required, string
    * `url`: required, string or null, format: uri
    * `spdx_id`: required, string or null
    * `node_id`: required, string
    * `html_url`: string, format: uri