---
title: "Get Grid Members"
method: GET
path: "/connect/gridmembers/"
tags: ["Grid"]
---

# Get Grid Members

`GET /connect/gridmembers/`

Retrieves the complete list of all machine members associated, in some capacity, with this grid. A grid member is not necessarily an official grid node.
For example, this list includes members that are not yet accepted into the grid, as well as members that have been rejected from joining the grid.

## Response `200`

The list of grid members

- ModelGridMember[]
  - `fingerprint` string — The security fingerprint to ensure the grid member requesting to join the grid matches is the actual grid member that was just setup
  - `id` string — The unique ID for this grid member
  - `name` string — The name of the grid member
  - `role` string — The role of this grid member, assigned during Security Onion setup
  - `status` string — The current membership status of this grid member

## Other responses

- `401` — Request was not properly authenticated
- `403` — Insufficient permissions for this request
- `405` — Grid member module has not been enabled on the server
- `500` — Internal SOC error; review SOC logs

---

[API](https://skmtc.net/security-onion-solutions/apis/security-onion-connect-api.md) · [All operations](https://skmtc.net/security-onion-solutions/apis/security-onion-connect-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/security-onion-solutions/security-onion-connect-api/revisions/0576ce393f8d/schema)