# Get all commonly used licenses

From **GitHub v3 REST API**.

`GET /licenses`

Get all commonly used licenses

## Parameters

### `featured`

- Location: query
- Required: false
- Type: `boolean`

### `per_page`

- Location: query
- Required: false
- Type: `integer`
- Default: `30`

Results per page (max 100)

### `page`

- Location: query
- Required: false
- Type: `integer`
- Default: `1`

Page number of the results to fetch.

## Responses

### `200`

Response

### `application/json`

- Type: `array`

```json
[
  {
    "key": "mit",
    "name": "MIT License",
    "node_id": "MDc6TGljZW5zZW1pdA==",
    "spdx_id": "MIT",
    "url": "https://api.github.com/licenses/mit"
  },
  {
    "key": "lgpl-3.0",
    "name": "GNU Lesser General Public License v3.0",
    "node_id": "MDc6TGljZW5zZW1pdA==",
    "spdx_id": "LGPL-3.0",
    "url": "https://api.github.com/licenses/lgpl-3.0"
  },
  {
    "key": "mpl-2.0",
    "name": "Mozilla Public License 2.0",
    "node_id": "MDc6TGljZW5zZW1pdA==",
    "spdx_id": "MPL-2.0",
    "url": "https://api.github.com/licenses/mpl-2.0"
  },
  {
    "key": "agpl-3.0",
    "name": "GNU Affero General Public License v3.0",
    "node_id": "MDc6TGljZW5zZW1pdA==",
    "spdx_id": "AGPL-3.0",
    "url": "https://api.github.com/licenses/agpl-3.0"
  },
  {
    "key": "unlicense",
    "name": "The Unlicense",
    "node_id": "MDc6TGljZW5zZW1pdA==",
    "spdx_id": "Unlicense",
    "url": "https://api.github.com/licenses/unlicense"
  },
  {
    "key": "apache-2.0",
    "name": "Apache License 2.0",
    "node_id": "MDc6TGljZW5zZW1pdA==",
    "spdx_id": "Apache-2.0",
    "url": "https://api.github.com/licenses/apache-2.0"
  },
  {
    "key": "gpl-3.0",
    "name": "GNU General Public License v3.0",
    "node_id": "MDc6TGljZW5zZW1pdA==",
    "spdx_id": "GPL-3.0",
    "url": "https://api.github.com/licenses/gpl-3.0"
  }
]
```

```json
{"items":{"$ref":"#/components/schemas/license-simple"},"type":"array"}
```

### `304`

Not modified

## Request examples

### cURL

```shell
curl --request GET \
  --url {protocol}://{hostname}/api/v3/licenses
```
