---
title: "List instance modules"
method: GET
path: "/instances/{id}/modules"
tags: ["Instance Modules"]
---

# List instance modules

`GET /instances/{id}/modules`

## Request

- Base URL: `https://api.cloudpepper.io`
- URL: `https://api.cloudpepper.io/instances/{id}/modules`
- Auth: HTTP bearer

Retrieves all addon modules (repositories) configured for the specified Odoo instance. This returns the same information displayed in the Addons tab of the instance interface, including Git repositories, Enterprise modules, and uploaded custom modules. This is useful for auditing which addons are connected to an instance, checking their versions and branches, or automating module management workflows.

**Key Parameters:**
- `id`: The unique identifier of the instance whose installed modules you want to check

**NOTE:** 
- This endpoint returns module repository information, not individual Odoo modules. To see which Odoo modules are actually installed and enabled, use the `/instances/{id}/installed-modules` endpoint instead. 
- "dirs": "*" means all the directories in that repo were added.

## Response `200`

Modules retrieved successfully

- Module[]
  - `id` string, uuid: Unique identifier for the module repository
  - `repo` string: Repository URL or identifier
  - `branch` string: Branch name being used
  - `dirs` string[], nullable: Specific directories used from the repository; null or ["*"] means the whole repository

## Other responses

- `403`: Insufficient permissions to view instance modules
- `404`: Instance not found

---

[API](https://skmtc.dev/cloudpepper/apis/cloudpepper-api-docs.md) · [All operations](https://skmtc.dev/cloudpepper/apis/cloudpepper-api-docs/llms.txt) · [OpenAPI document](https://skmtc.dev/cloudpepper/apis/cloudpepper-api-docs/revisions/b6a59274cedc?raw)