---
title: "Get Session Connections"
method: GET
path: "/v3/sessions/connections"
tags: ["Sessions"]
---

# Get Session Connections

`GET /v3/sessions/connections`

Returns a graph of connections between source and destination fields.
Useful for visualizing network relationships and communication patterns.

## Query parameters

- `scope` 'workspace' | 'demo'
- `start_time` string, date-time, required
- `end_time` string, date-time, required
- `query` string
- `src_field` string
- `dest_field` string
- `max_nodes` integer
- `min_connections` integer

## Response `200`

OK - request successful.

- SessionConnectionsResponse
  - `nodes` SessionConnectionNode[] — Network nodes in the connection graph.
    - `id` string — Node identifier (field value).
    - `type` string — Whether this is a source or destination node.
  - `links` SessionConnectionLink[] — Connections between nodes.
    - `source` string — Source node identifier.
    - `target` string — Target node identifier.
    - `value` integer — Number of connections between source and target.
  - `total` integer — Total number of connections.
  - `request_metadata` object
    - `start_time` string
    - `end_time` string
    - `query` string
    - `src_field` string
    - `dest_field` string
    - `max_nodes` integer
    - `min_connections` integer

## Other responses

- `400` — Bad request - request syntax is invalid for the specified endpoint. Verify request syntax and try again.
- `401` — Unauthorized. Please check your API key.
- `403` — Forbidden - request is not authorized due to an invalid API key or plan limitations. If due to plan limitations, contact sales@greynoise.io to upgrade your plan and unlock full results.
- `429` — Too many requests. You've hit the rate-limit.
- `500` — Unexpected error

---

[API](https://skmtc.dev/greynoise/apis/greynoise-api.md) · [All operations](https://skmtc.dev/greynoise/apis/greynoise-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greynoise/greynoise-api/revisions/30942574656d/schema)