---
title: "GET /v1/custom-plugins"
method: GET
path: "/v1/custom-plugins"
---

# GET /v1/custom-plugins

`GET /v1/custom-plugins`

Returns a list of all of the custom plugins in this account and Region.

## Query parameters

- `maxResults` integer
- `nextToken` string
- `namePrefix` string

## Response `200`

Success

- ListCustomPluginsResponse
  - `customPlugins` CustomPluginSummary[] — An array of custom plugin descriptions.
    - `creationTime` string, date-time — The time that the custom plugin was created.
    - `customPluginArn` string — The Amazon Resource Name (ARN) of the custom plugin.
    - `customPluginState` 'CREATING' | 'CREATE_FAILED' | 'ACTIVE' | 'UPDATING' | 'UPDATE_FAILED' | 'DELETING' — The state of the custom plugin.
    - `description` string — A description of the custom plugin.
    - `latestRevision` object — The latest revision of the custom plugin.
      - `contentType` 'JAR' | 'ZIP' — The format of the plugin file.
      - `creationTime` string, date-time — The time that the custom plugin was created.
      - `description` string — The description of the custom plugin.
      - `fileDescription` object — Details about the custom plugin file.
        - `fileMd5` string — The hex-encoded MD5 checksum of the custom plugin file. You can use it to validate the file.
        - `fileSize` integer — The size in bytes of the custom plugin file. You can use it to validate the file.
      - `location` object — Information about the location of the custom plugin.
        - `s3Location` object — The S3 bucket Amazon Resource Name (ARN), file key, and object version of the plugin file stored in Amazon S3.
          - `bucketArn` string — The Amazon Resource Name (ARN) of an S3 bucket.
          - `fileKey` string — The file key for an object in an S3 bucket.
          - `objectVersion` string — The version of an object in an S3 bucket.
      - `revision` integer — The revision of the custom plugin.
    - `name` string — The name of the custom plugin.
  - `nextToken` string — If the response of a ListCustomPlugins operation is truncated, it will include a NextToken. Send this NextToken in a subsequent request to continue listing from where the previous operation left off.

## Other responses

- `480` — NotFoundException
- `481` — BadRequestException
- `482` — ForbiddenException
- `483` — ServiceUnavailableException
- `484` — TooManyRequestsException
- `485` — UnauthorizedException
- `486` — InternalServerErrorException

---

[API](https://skmtc.net/aws/apis/kafkaconnect.md) · [All operations](https://skmtc.net/aws/apis/kafkaconnect/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/kafkaconnect/versions/bf394e0acb7e/schema)