---
title: "GET /targetgroups"
method: GET
path: "/targetgroups"
---

# GET /targetgroups

`GET /targetgroups`

Lists your target groups. You can narrow your search by using the filters below in your request.

## Query parameters

- `maxResults` integer
- `nextToken` string
- `vpcIdentifier` string
- `targetGroupType` 'IP' | 'LAMBDA' | 'INSTANCE' | 'ALB'

## Response `200`

Success

- ListTargetGroupsResponse
  - `items` TargetGroupSummary[] — Information about the target groups.
    - `id` string — The ID of the target group.
    - `arn` string — The ARN (Amazon Resource Name) of the target group.
    - `name` string — The name of the target group.
    - `type` 'IP' | 'LAMBDA' | 'INSTANCE' | 'ALB' — The target group type.
    - `createdAt` string, date-time — The date and time that the target group was created, in ISO-8601 format.
    - `port` integer — The port of the target group.
    - `protocol` 'HTTP' | 'HTTPS' | 'TCP' — The protocol of the target group.
    - `ipAddressType` 'IPV4' | 'IPV6' — The type of IP address used for the target group. The possible values are <code>IPV4</code> and <code>IPV6</code>. This is an optional parameter. If not specified, the default is <code>IPV4</code>.
    - `vpcIdentifier` string — The ID of the VPC of the target group.
    - `lastUpdatedAt` string, date-time — The date and time that the target group was last updated, in ISO-8601 format.
    - `status` 'CREATE_IN_PROGRESS' | 'ACTIVE' | 'DELETE_IN_PROGRESS' | 'CREATE_FAILED' | 'DELETE_FAILED' — The status.
    - `serviceArns` ServiceArn[] — The Amazon Resource Names (ARNs) of the service.
    - `lambdaEventStructureVersion` 'V1' | 'V2' — The version of the event structure that your Lambda function receives. Supported only if the target group type is <code>LAMBDA</code>.
  - `nextToken` string — If there are additional results, a pagination token for the next page of results.

## Other responses

- `480` — ValidationException
- `481` — AccessDeniedException
- `482` — ThrottlingException
- `483` — InternalServerException

---

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