---
title: "Fetches a list of pending circuit proposals for this node"
method: GET
path: "/admin/proposals"
tags: ["Proposals"]
---

# Fetches a list of pending circuit proposals for this node

`GET /admin/proposals`

This endpoint can be used to view all of the circuit proposals that the
node is a proposed member of. If a circuit management type is provided
via the "management_type" query parameter, only circuit proposals that
have the given circuit management type will be returned. If a node ID is
provided via the "member" query parameter, only circuit proposals that
have the given node as a member will be returned. If no filter is
provided, all of the node's circuit proposals will be returned.

This endpoint requires the permission "circuit.read".

## Query parameters

- `offset` integer
- `limit` integer
- `management_type` string
- `member` string

## Headers

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

## Response `200`

Successfully retrieved the list of proposals

- object
  - `data` 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
  - `paging` Paging
    - `current` string
    - `offset` integer
    - `limit` integer
    - `total` integer
    - `first` string
    - `prev` string
    - `next` string
    - `last` string

## Other responses

- `400` — Request was malformed
- `401` — The client is unauthorized
- `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)