---
title: "Fetches a circuit by its ID"
method: GET
path: "/admin/circuits/{circuit_id}"
tags: ["Circuits"]
---

# Fetches a circuit by its ID

`GET /admin/circuits/{circuit_id}`

This endpoint can be used to view a specific circuit that the node is a
member of.

This endpoint requires the permission "circuit.read".

## Path parameters

- `circuit_id` string, required

## Headers

- `Authorization` string, required
- `SplinterProtocolVersion` integer

## Response `200`

Successfully retrieved the requested circuit

- Circuit
  - `id` string
  - `members` CircuitMember[] — Circuit members in the circuit
    - `node_id` string
    - `endpoints` string[]
    - `public_key` string
  - `roster` CircuitService[] — All services defined for the circuit
    - `service_id` string
    - `service_type` string
    - `node_id` string — The node ID that is allowed to run this service
  - `management_type` string
  - `display_name` string, nullable — Human readable name for the circuit
  - `circuit_status` 'Active' | 'Disbanded' | 'Abandoned', nullable — The status of the circuit

## Other responses

- `401` — The client is unauthorized
- `404` — The requested circuit was not found
- `500` — An internal server error occurred

---

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