***

title: get_agent
slug: /reference/python/agents/agent-server/get-agent
description: Retrieve a specific registered agent by its route.
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/python/agents/agent-base

Retrieve a specific agent by its route. Returns `None` if no agent is registered at
the given path.

## **Parameters**

<ParamField path="route" type="str" required={true} toc={true}>
  The route to look up (e.g., `"/sales"`). Leading slashes are added and trailing slashes
  are stripped automatically for matching.
</ParamField>

## **Returns**

[`AgentBase`][agentbase] | `None` -- The agent instance
registered at the route, or `None` if not found.

## **Example**

```python {8}
from signalwire import AgentServer
from signalwire import AgentBase

agent1 = AgentBase(name="sales", route="/sales")
agent2 = AgentBase(name="support", route="/support")
server = AgentServer(port=3000)
server.register(agent1)
agent = server.get_agent("/sales")
if agent:
    print(f"Found: {agent.get_name()}")
else:
    print("No agent at /sales")
```