---
title: "GET /networks/{networkId}/proposals/{proposalId}"
method: GET
path: "/networks/{networkId}/proposals/{proposalId}"
---

# GET /networks/{networkId}/proposals/{proposalId}

`GET /networks/{networkId}/proposals/{proposalId}`

Returns detailed information about a proposal.

Applies only to Hyperledger Fabric.

## Path parameters

- `networkId` string, required
- `proposalId` string, required

## Response `200`

Success

- GetProposalOutput
  - `Proposal` object — Information about a proposal.
    - `ProposalId` string — The unique identifier of the proposal.
    - `NetworkId` string — The unique identifier of the network for which the proposal is made.
    - `Description` string — The description of the proposal.
    - `Actions` object — The actions to perform on the network if the proposal is <code>APPROVED</code>.
      - `Invitations` InviteAction[] — The actions to perform for an <code>APPROVED</code> proposal to invite an Amazon Web Services account to create a member and join the network.
        - `Principal` string, required — The Amazon Web Services account ID to invite.
      - `Removals` RemoveAction[] — The actions to perform for an <code>APPROVED</code> proposal to remove a member from the network, which deletes the member and all associated member resources from the network.
        - `MemberId` string, required — The unique identifier of the member to remove.
    - `ProposedByMemberId` string — The unique identifier of the member that created the proposal.
    - `ProposedByMemberName` string — The name of the member that created the proposal.
    - `Status` 'IN_PROGRESS' | 'APPROVED' | 'REJECTED' | 'EXPIRED' | 'ACTION_FAILED' — <p>The status of the proposal. Values are as follows:</p> <ul> <li> <p> <code>IN_PROGRESS</code> - The proposal is active and open for member voting.</p> </li> <li> <p> <code>APPROVED</code> - The proposal was approved with sufficient <code>YES</code> votes among members according to the <code>VotingPolicy</code> specified for the <code>Network</code>. The specified proposal actions are carried out.</p> </li> <li> <p> <code>REJECTED</code> - The proposal was rejected with insufficient <code>YES</code> votes among members according to the <code>VotingPolicy</code> specified for the <code>Network</code>. The specified <code>ProposalActions</code> aren't carried out.</p> </li> <li> <p> <code>EXPIRED</code> - Members didn't cast the number of votes required to determine the proposal outcome before the proposal expired. The specified <code>ProposalActions</code> aren't carried out.</p> </li> <li> <p> <code>ACTION_FAILED</code> - One or more of the specified <code>ProposalActions</code> in a proposal that was approved couldn't be completed because of an error. The <code>ACTION_FAILED</code> status occurs even if only one ProposalAction fails and other actions are successful.</p> </li> </ul>
    - `CreationDate` string, date-time — The date and time that the proposal was created.
    - `ExpirationDate` string, date-time — The date and time that the proposal expires. This is the <code>CreationDate</code> plus the <code>ProposalDurationInHours</code> that is specified in the <code>ProposalThresholdPolicy</code>. After this date and time, if members haven't cast enough votes to determine the outcome according to the voting policy, the proposal is <code>EXPIRED</code> and <code>Actions</code> aren't carried out.
    - `YesVoteCount` integer — The current total of <code>YES</code> votes cast on the proposal by members.
    - `NoVoteCount` integer — The current total of <code>NO</code> votes cast on the proposal by members.
    - `OutstandingVoteCount` integer — The number of votes remaining to be cast on the proposal by members. In other words, the number of members minus the sum of <code>YES</code> votes and <code>NO</code> votes.
    - `Tags` object — <p>Tags assigned to the proposal. Each tag consists of a key and optional value.</p> <p>For more information about tags, see <a href="https://docs.aws.amazon.com/managed-blockchain/latest/ethereum-dev/tagging-resources.html">Tagging Resources</a> in the <i>Amazon Managed Blockchain Ethereum Developer Guide</i>, or <a href="https://docs.aws.amazon.com/managed-blockchain/latest/hyperledger-fabric-dev/tagging-resources.html">Tagging Resources</a> in the <i>Amazon Managed Blockchain Hyperledger Fabric Developer Guide</i>.</p>
    - `Arn` string — The Amazon Resource Name (ARN) of the proposal. For more information about ARNs and their format, see <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">Amazon Resource Names (ARNs)</a> in the <i>Amazon Web Services General Reference</i>.

## Other responses

- `480` — InvalidRequestException
- `481` — AccessDeniedException
- `482` — ResourceNotFoundException
- `483` — ThrottlingException
- `484` — InternalServiceErrorException

---

[API](https://skmtc.net/aws/apis/managedblockchain.md) · [All operations](https://skmtc.net/aws/apis/managedblockchain/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/managedblockchain/versions/43406c4e72b1/schema)