---
title: "Retrieves a list of plugins that matches a certain type"
method: GET
path: "/api/v2/configurations/plugins"
tags: ["v2 configurations"]
---

# Retrieves a list of plugins that matches a certain type

`GET /api/v2/configurations/plugins`

## Query parameters

- `type` string[], required

## Response `200`

Returns a set of plugin information

- PluginInfoList
  - `pluginInfoList` PluginInfo[]
    - `id` string
    - `name` string
    - `version` string
    - `description` string
    - `type` 'INGEST' | 'INTERNAL' | 'SIP_TO_AIP' | 'AIP_TO_SIP' | 'AIP_TO_AIP' | 'MISC' | 'MULTI'
    - `categories` string[]
    - `parameters` PluginParameter[]
      - `id` string
      - `name` string
      - `type` 'STRING' | 'BOOLEAN' | 'INTEGER' | 'PLUGIN_SIP_TO_AIP' | 'AIP_ID' | 'RISK_ID' | 'SEVERITY' | 'REPRESENTATION_TYPE' | 'RODA_OBJECT' | 'AIP_FIELDS' | 'REPRESENTATION_FIELDS' | 'FILE_FIELDS' | 'PERMISSION_TYPES' | 'DROPDOWN' | 'CONVERSION_PROFILE' | 'CONVERSION'
      - `defaultValue` string
      - `possibleValues` string[]
      - `mandatory` boolean
      - `readonly` boolean
      - `description` string
      - `renderingHints` RenderingHints
    - `objectClasses` string[]
    - `hasLicenseFile` boolean
    - `licenseFilePath` string
    - `hasDocumentationFile` boolean
    - `documentationFilePath` string
    - `marketInfo` MarketInfo
      - `installation` string
      - `id` string
      - `name` string
      - `type` string
      - `version` string
      - `description` string
      - `plugin` Plugin
        - `objectClasses` string[]
        - `categories` string[]
        - `type` 'INGEST' | 'INTERNAL' | 'SIP_TO_AIP' | 'AIP_TO_SIP' | 'AIP_TO_AIP' | 'MISC' | 'MULTI'
      - `license` LicenseInfo
        - `name` string
        - `url` string
      - `homepage` string
      - `vendor` Vendor
        - `name` string
        - `homepage` string
      - `compatibility` string[]
    - `verified` boolean
    - `installed` boolean

## Other responses

- `401` — Unauthorized
- `403` — Access forbidden

---

[API](https://skmtc.net/keeps/apis/roda-rest-api.md) · [All operations](https://skmtc.net/keeps/apis/roda-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/keeps/roda-rest-api/revisions/afc3c5bcc0d9/schema)