> ## Documentation Index > Fetch the complete documentation index at: https://developers.telnyx.com/llms.txt > Use this file to discover all available pages before exploring further. # List Agent Gateways > Lists the account's Agent Gateway instances, newest first, one page at a time. ## OpenAPI ````yaml /openapi/source/external/agent-gateway/agent-gateway.json get /agent_gateways openapi: 3.1.0 info: version: 1.0.0 title: Telnyx API x-latency-category: interactive x-endpoint-cost: light description: >- Agent Gateway authenticates, authorizes, and audits the requests agents send to models, tools, and other agents. Each gateway runs as a dedicated instance on the account's [*Network*](https://developers.telnyx.com/docs/network/overview). This API creates, lists, and deletes instances, and manages the keys, teams, spend logs, MCP servers, APIs, tool permissions, and guardrails on them. Each instance serves an OpenAI-compatible API at its `gateway_url`. servers: - url: https://api.telnyx.com/v2 description: Telnyx API v2 security: - bearerAuth: [] tags: - name: Agent Gateways description: Create, list, retrieve, and delete Agent Gateway instances. - name: Agent Gateway Keys description: Keys on an instance. - name: Agent Gateway Teams description: 'Teams on an instance: shared model lists, budgets, and rate limits.' - name: Agent Gateway Spend Logs description: The requests an instance served, with their cost. - name: Agent Gateway MCP Servers description: MCP servers on an instance, served to agents at one MCP endpoint. - name: Agent Gateway APIs description: REST APIs on an instance, served to agents as tools. - name: Agent Gateway Tool Permissions description: The MCP servers and tools a key or team may use. - name: Agent Gateway Guardrails description: Checks an instance runs on model and tool requests. - name: Agent Gateway Policies description: Named sets of guardrails an instance applies to requests. - name: Agent Gateway Policy Attachments description: Where an instance applies each policy. paths: /agent_gateways: get: tags: - Agent Gateways summary: List Agent Gateways description: >- Lists the account's Agent Gateway instances, newest first, one page at a time. operationId: ListAgentGateways parameters: - name: page[number] in: query required: false description: The page to return, counting from 1. schema: type: integer minimum: 1 default: 1 - name: page[size] in: query required: false description: Results per page. schema: type: integer minimum: 1 maximum: 100 default: 50 responses: '200': description: One page of instances content: application/json: schema: $ref: '#/components/schemas/AgentGatewayListResponse' example: data: - id: ecffdf4b-93ea-4a7b-8295-51dfd2077996 name: support-gw engine: litellm engine_version: v1.105.1 status: ready gateway_url: http://172.27.0.3:4000 wireguard_interface_id: c788eb40-a4c0-4bf5-8f84-976027960f8e network_id: 7ade8c3c-95a7-447b-92f2-c829f760159c created_at: '2026-10-21T19:32:48.377714Z' meta: total_results: 1 page_number: 1 page_size: 50 total_pages: 1 '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/TelnyxErrors' example: errors: - code: '10009' title: Authentication failed detail: >- The required authentication headers were either invalid or not included in the request. meta: url: https://developers.telnyx.com/docs/overview/errors/10009 '422': description: Invalid paging parameters content: application/json: schema: $ref: '#/components/schemas/TelnyxErrors' example: errors: - code: '10033' title: Value outside of range detail: Input should be greater than or equal to 1 source: parameter: page[size] meta: url: https://developers.telnyx.com/docs/overview/errors/10033 x-codeSamples: - lang: JavaScript source: |- import Telnyx from 'telnyx'; const client = new Telnyx({ apiKey: process.env['TELNYX_API_KEY'], // This is the default and can be omitted }); // Automatically fetches more pages as needed. for await (const response of client.agentGateways.list()) { console.log(response); } - lang: Python source: | import os from telnyx import Telnyx client = Telnyx( api_key=os.environ.get("TELNYX_API_KEY"), # This is the default and can be omitted ) page = client.agent_gateways.list() print(page.data) - lang: Go source: "package main\n\nimport (\n\t\"context\"\n\t\"fmt\"\n\n\t\"github.com/team-telnyx/telnyx-go\"\n\t\"github.com/team-telnyx/telnyx-go/option\"\n)\n\nfunc main() {\n\tclient := telnyx.NewClient(\n\t\toption.WithAPIKey(\"My API Key\"),\n\t)\n\tagentGateways, err := client.AgentGateways.List(context.TODO())\n\tif err != nil {\n\t\tpanic(err.Error())\n\t}\n\tfmt.Printf(\"%+v\\n\", agentGateways.Data)\n}\n" - lang: Java source: |- package com.telnyx.sdk.example; import com.telnyx.sdk.client.TelnyxClient; import com.telnyx.sdk.client.okhttp.TelnyxOkHttpClient; public final class Main { private Main() {} public static void main(String[] args) { TelnyxClient client = TelnyxOkHttpClient.fromEnv(); var page = client.agentGateways().list(); } } - lang: Ruby source: |- require "telnyx" telnyx = Telnyx::Client.new(api_key: "My API Key") page = telnyx.agent_gateways.list puts(page) - lang: PHP source: >- agentGateways->list(); var_dump($page); } catch (APIException $e) { echo $e->getMessage(); } - lang: CLI source: |- telnyx agent-gateways list \ --api-key 'My API Key' components: schemas: AgentGatewayListResponse: type: object required: - data - meta properties: data: type: array items: $ref: '#/components/schemas/AgentGateway' meta: $ref: '#/components/schemas/PageMeta' TelnyxErrors: type: object properties: errors: type: array items: $ref: '#/components/schemas/TelnyxError' AgentGateway: type: object description: An Agent Gateway instance on a WireGuard Interface. required: - id - name - engine - engine_version - status - gateway_url - wireguard_interface_id - network_id - created_at properties: id: type: string format: uuid description: Identifies the instance. name: anyOf: - type: string - type: 'null' description: A label for people; `null` when none was given. engine: type: string const: litellm description: The gateway engine. engine_version: type: string description: The engine version the instance runs. status: $ref: '#/components/schemas/AgentGatewayStatus' gateway_url: anyOf: - type: string - type: 'null' description: >- The base URL of the instance's API, `http://
:4000`, where the address is the instance's peer address on the WireGuard Interface. Reachable only from hosts on the instance's *Network*, and every request to it carries a key from this API. `null` until the instance is `ready`. wireguard_interface_id: anyOf: - type: string format: uuid - type: 'null' description: The WireGuard Interface the instance joins as a peer. network_id: anyOf: - type: string format: uuid - type: 'null' description: >- The [*Network*](https://developers.telnyx.com/docs/network/overview) the WireGuard Interface belongs to. created_at: type: string format: date-time description: When the instance was created. PageMeta: type: object required: - total_results - page_number - page_size - total_pages properties: total_results: type: integer description: Results across every page. page_number: type: integer description: The page returned, counting from 1. page_size: type: integer description: Results per page. total_pages: type: integer description: Pages that can be requested; 0 when nothing matched. TelnyxError: type: object properties: code: type: string title: type: string detail: type: string source: type: object properties: pointer: type: string parameter: type: string meta: type: object properties: url: type: string AgentGatewayStatus: type: string enum: - pending - provisioning - ready - failed - deleting description: >- Where the instance is in its lifecycle. `pending`: created and waiting to start. `provisioning`: starting. `ready`: running, with its `gateway_url` set. `failed`: did not start in time; delete it. `deleting`: being removed. securitySchemes: bearerAuth: type: http scheme: bearer description: Telnyx API key ````