---
title: "List GatewayConfigs."
method: GET
path: "/v1/gateway-configs"
tags: ["gateway-configs"]
---

# List GatewayConfigs.

`GET /v1/gateway-configs`

List all GatewayConfigs for the authenticated account, including system-provided configs like 'anthropic' and 'openai'.

## Query parameters

- `name` string
- `id` string
- `limit` integer
- `starting_after` string
- `include_total_count` boolean

## Response `200`

Successfully retrieved list of GatewayConfigs.

- GatewayConfigListView — A paginated list of GatewayConfigs.
  - `gateway_configs` GatewayConfigView[], required — The list of GatewayConfigs.
    - `id` string, required — The unique identifier of the GatewayConfig.
    - `account_id` string, nullable — The account ID that owns this config.
    - `name` string, required — The human-readable name of the GatewayConfig. Unique per account (or globally for system configs).
    - `endpoint` string, required — The target endpoint URL (e.g., 'https://api.anthropic.com').
    - `auth_mechanism` AuthMechanismView, required — Defines how credentials are applied to HTTP requests when proxying through the gateway.
      - `type` string, required — The type of authentication mechanism: 'header', 'bearer'.
      - `key` string, nullable — For 'header' type: the header name (e.g., 'x-api-key').
    - `description` string, nullable — Optional description for this gateway configuration.
    - `create_time_ms` integer, required — Creation time of the GatewayConfig (Unix timestamp in milliseconds).
  - `has_more` boolean, required — Whether there are more results available beyond this page.
  - `total_count` integer, nullable — Total count of GatewayConfigs that match the query.

## Other responses

- `401` — Unauthorized. Invalid or missing authentication.
- `403` — Forbidden. Account does not have devbox capability.
- `500` — Internal server error.

## Changes

- **2026-03-24** `32e4b2dfb757` — 1 info
  - added the new optional `query` request parameter `include_total_count`
- **2026-02-19** `8704a652545c` — 2 breaking
  - the response property `total_count` became nullable for the status `200`
  - the response property `total_count` became optional for the status `200`
- **2026-01-30** `debd1f9a9d59` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/runloopai/apis/runloop-api/changes/v1/gateway-configs/get.md)

---

[API](https://skmtc.dev/runloopai/apis/runloop-api.md) · [All operations](https://skmtc.dev/runloopai/apis/runloop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/runloopai/runloop-api/revisions/a1c7e69cbbf7/schema)