---
title: "GET /agent/type/{type}"
method: GET
path: "/agent/type/{type}"
tags: ["agent"]
---

# GET /agent/type/{type}

`GET /agent/type/{type}`

Get agent by type

## Path parameters

- `type` string, required — type of agent

## Response `200`

AgentsLocationList

- AgentsLocationList
  - `data` AgentsLocation[]
    - `active` integer
    - `create_date` string, date-time
    - `expire_date` string, date-time
    - `gid` integer
    - `host` string
    - `node` string
    - `path` string
    - `port` integer
    - `protocol` string
    - `ttl` integer
    - `type` string
    - `uuid` string

## Other responses

- `400` — FailureResponse

## Changes

> 16 revisions in range; 1 could not be searched.

- **2021-11-03** `8b089db7394c` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **2021-11-03** `31e15898198d` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **2021-10-19** `2ab28454b40f` — 7 info
  - the endpoint scheme security `SecurityDefinitions` was added to the API
  - the endpoint scheme security `in` was added to the API
  - the endpoint scheme security `name` was added to the API
  - the endpoint scheme security `type` was added to the API
  - …3 more
- **2020-04-01** `8739183b4c43` — 1 breaking, 1 warning, 1 info
  - added the new path request parameter `type`
  - deleted the `path` request parameter `type of agent`
  - api operation id `GetAgentByType` removed and replaced with `agentsSubGetAgentsubByType`
- **2020-01-30** `799e4fd8f4f4` — 1 info
  - endpoint added

[Full history](https://skmtc.dev/sipcapture/apis/homer-app/changes/agent/type/:type/get.md)

---

[API](https://skmtc.dev/sipcapture/apis/homer-app.md) · [All operations](https://skmtc.dev/sipcapture/apis/homer-app/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sipcapture/homer-app/revisions/2f261ecc6074/schema)