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

# GET /agent/subscribe/{guid}

`GET /agent/subscribe/{guid}`

Get agent by guid

## Path parameters

- `guid` string, required — guid of agent

## Response `201`

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

- **2026-07-17** `2f261ecc6074` — 1 info
  - the security scope `[]` was added to the endpoint's security scheme `bearer`
- **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 `guid`
  - deleted the `path` request parameter `type of agent`
  - api operation id `GetAgentByGUID` removed and replaced with `agentsSubGetAgentsubAgainstGUID`

[Full history](https://skmtc.dev/sipcapture/apis/homer-app/changes/agent/subscribe/:guid/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)