***

title: getAgent
slug: /reference/typescript/agents/agent-server/get-agent
description: Look up a registered agent by its route prefix.
max-toc-depth: 3
---------------------

For a complete index of all SignalWire documentation pages, fetch https://signalwire.com/docs/llms.txt

[agentbase]: /docs/server-sdks/reference/typescript/agents/agent-base

Look up a registered agent by its route prefix. Returns `undefined` if no agent is
registered at the given path.

## **Parameters**

<ParamField path="route" type="string" required={true} toc={true}>
  The route prefix to look up (e.g., `"/sales"`).
</ParamField>

## **Returns**

[`AgentBase`][agentbase] ` | undefined` -- The agent at that route, or `undefined`
if none is registered.

## **Example**

```typescript {7}
import { AgentBase, AgentServer } from '@signalwire/sdk';

const agent1 = new AgentBase({ name: 'sales', route: '/sales' });
const server = new AgentServer({ port: 3000 });
server.register(agent1);

const agent = server.getAgent('/sales');
if (agent) {
  console.log(`Found: ${agent.name}`);
} else {
  console.log('No agent at /sales');
}
```