---
title: "Queries Gremlin's view of Load balancers in a given AWS account"
method: GET
path: "/aws/metadata/load-balancers"
tags: ["aws.metadata"]
---

# Queries Gremlin's view of Load balancers in a given AWS account

`GET /aws/metadata/load-balancers`

This endpoint returns Gremlin's view of Load Balancers in a given AWS account.  These can then be used to create Gremlin Services or Intelligent Health checks.  
The `domain` parameter refers to the AWS AccountId.  
NOTE: This endpoint may (or may not) return Load Balancers which have already been assigned to Gremlin Services, or ones which we cannot assign to Gremlin Services (eg. LBs with no hosts behind them)
Requires the privilege [`MINIMUM_TEAM_PRIVILEGES`](https://www.gremlin.com/docs/user-management/access-control/#privileges)

## Query parameters

- `domain` string, required
- `mode` 'Onboarding'
- `teamId` string, required

## Response `default`

default response

- AwsLoadBalancersForAccount
  - `domain` string
  - `loadBalancers` AwsLoadBalancerResponse[]
    - `type` string
    - `name` string
    - `arn` string
    - `dnsName` string
    - `region` string
    - `tags` object
    - `serviceIds` string[]
    - `targetingStrategy` TargetingStrategy
      - `type` string, required
    - `targetingStrategyDetectionScore` number, double
    - `discoveredAt` string, date-time

## Other responses

- `401` — Authorization header missing or malformed. Please provide proper credentials in the authorization header.
- `403` — User requires privilege for target team: MINIMUM_TEAM_PRIVILEGES

---

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