---
title: "Fetches a circuit proposal by the circuit's ID"
method: GET
path: "/admin/proposals/{circuit_id}"
tags: ["Proposals"]
---

# Fetches a circuit proposal by the circuit's ID

`GET /admin/proposals/{circuit_id}`

This endpoint can be used to view a specific circuit proposal that the
node is a proposed 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 proposal

- Proposal
  - `proposal_type` 'Create' | 'UpdateRoster' | 'AddNode' | 'RemoveNode' | 'Disband'
  - `circuit_id` string
  - `circuit_hash` string
  - `circuit` object
    - `circuit_id` string
    - `members` ProposedCircuitMember[]
      - `node_id` string
      - `endpoints` string[]
      - `public_key` string
    - `roster` ProposedCircuitService[]
      - `service_id` string
      - `service_type` string
      - `node_id` string — The node ID that is allowed to run this service
      - `arguments` array[] — Arbitrary arguments to be passed to this service on initialization, formatted as an array of (key, value) pairs
        - string[]
    - `management_type` string
    - `application_metadata` string, binary
    - `comments` string — Arbitrary comments to describe the proposed circuit
    - `display_name` string, nullable — Human readable name for the circuit
    - `circuit_version` integer — The protocol version the circuit adheres to
    - `circuit_status` 'Active' | 'Disbanded' | 'Abandoned' — The status of the circuit
  - `votes` Vote[]
    - `public_key` string
    - `vote` 'Accept' | 'Reject'
    - `voter_node_id` string
  - `requester` string
  - `requester_node_id` string

## Other responses

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

## Changes

- **2021-05-21** `b560f0043bbf` — 1 info
  - added the optional property `circuit/members/items/public_key` to the response with the `200` status
- **2021-05-21** `0e44123af889` — 1 warning
  - removed the optional property `circuit/members/items/public_key` from the response with the `200` status

[Change history](https://skmtc.dev/cargill/apis/splinterd-api/changes/admin/proposals/: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)