---
title: "GET /gateways/{gatewayIdentifier}/targets/"
method: GET
path: "/gateways/{gatewayIdentifier}/targets/"
---

# GET /gateways/{gatewayIdentifier}/targets/

`GET /gateways/{gatewayIdentifier}/targets/`

Lists all targets for a specific gateway.

## Path parameters

- `gatewayIdentifier` string, required

## Query parameters

- `maxResults` integer
- `nextToken` string

## Response `200`

Success

- ListGatewayTargetsResponse
  - `items` TargetSummary[], required — The list of gateway target summaries.
    - `targetId` string, required — The unique identifier of the target.
    - `name` string, password, required — The name of the target.
    - `status` 'CREATING' | 'UPDATING' | 'UPDATE_UNSUCCESSFUL' | 'DELETING' | 'READY' | 'FAILED' | 'SYNCHRONIZING' | 'SYNCHRONIZE_UNSUCCESSFUL' | 'CREATE_PENDING_AUTH' | 'UPDATE_PENDING_AUTH' | 'SYNCHRONIZE_PENDING_AUTH', required — The current status of the target.
    - `description` string, password — The description of the target.
    - `createdAt` string, date-time, required — The timestamp when the target was created.
    - `updatedAt` string, date-time, required — The timestamp when the target was last updated.
    - `resourcePriority` integer — Priority for resolving resource URI conflicts across targets. Lower values take precedence. Defaults to 1000 when not set.
    - `lastSynchronizedAt` string, date-time — The timestamp when the target was last synchronized.
    - `authorizationData` AuthorizationData — Contains the authorization data that is returned when a gateway target is configured with a credential provider with authorization code grant type and requires user federation.
      - `oauth2` object — OAuth2 authorization data for the gateway target.
        - `authorizationUrl` string, required — The URL to initiate the authorization process. This URL is provided when the OAuth2 access token requires user authorization.
        - `userId` string — The user identifier associated with the OAuth2 authorization session that is defined by AgentCore Gateway.
    - `targetType` 'OPEN_API_SCHEMA' | 'SMITHY_MODEL' | 'MCP_SERVER' | 'LAMBDA' | 'API_GATEWAY' | 'CONNECTOR' | 'AGENTCORE_RUNTIME' | 'PASSTHROUGH' | 'PROVIDER' — The type of the target.
    - `listingMode` 'DEFAULT' | 'DYNAMIC' — The listing mode for the target. MCP resources for <code>DEFAULT</code> targets are cached at the control plane for faster access. MCP resources for <code>DYNAMIC</code> targets are retrieved dynamically when listing tools.
  - `nextToken` string — If the total number of results is greater than the <code>maxResults</code> value provided in the request, use this token when making another request in the <code>nextToken</code> field to return the next batch of results.

## Other responses

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

---

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