---
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

## Changes

- **2021-05-21** `b560f0043bbf` — 1 breaking, 3 info
  - the `members/items/` response's property type changed from `string` to `object` for status `200`
  - added the optional property `members/items/endpoints` to the response with the `200` status
  - added the optional property `members/items/node_id` to the response with the `200` status
  - added the optional property `members/items/public_key` to the response with the `200` status
- **2021-05-21** `0e44123af889` — 1 breaking, 3 warning
  - the `members/items/` response's property type changed from `object` to `string` for status `200`
  - removed the optional property `members/items/endpoints` from the response with the `200` status
  - removed the optional property `members/items/node_id` from the response with the `200` status
  - removed the optional property `members/items/public_key` from the response with the `200` status

[Change history](https://skmtc.dev/cargill/apis/splinterd-api/changes/admin/circuits/:circuit_id/get.md)

---

[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)