---
title: "List gateways"
method: GET
path: "/v2/gateways"
tags: ["Gateways"]
---

# List gateways

`GET /v2/gateways`

## Request

- Base URL: `https://app.aiva.works` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aiva.works/v2/gateways`
- Auth: API key in header `X-API-KEY`

Lists the gateways tests can run through.

## Query parameters

- `page` integer
- `pageSize` integer

## Response `200`

Array of gateways

- Gateway[]
  - `id` string, guid, required
  - `name` string, required
  - `isDefault` boolean
  - `status` 'Connected' | 'Disconnected' | 'NeverConnected'

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Server Error

---

[API](https://skmtc.dev/aiva/apis/aiva-cloud-api.md) · [All operations](https://skmtc.dev/aiva/apis/aiva-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aiva/apis/aiva-cloud-api/revisions/70eef14d3bcd?raw)