Skip to main content
GET
Get a specific proposal
Retrieves detailed information about a specific proposal, including current status, voting state, and metadata. By default, status is client-facing. For proposals that are internally closed on-chain, the API infers terminal outcome when possible (executed, cancelled, or rejected). Use showOnChainStatus=true to return the raw on-chain status value (including closed).
The {address} parameter is your smart account address, and {proposal_address} is the specific proposal’s on-chain address from Create Proposal or List Proposals.

Ownership Verification

The API verifies that the proposal belongs to the specified smart account. Requesting a proposal with the wrong account address returns 403 Forbidden.

Understanding Voting State

The response includes approved, rejected, and cancelled arrays showing which signers have voted:

Authorizations

Authorization
string
header
required

Your Grid API key from the Grid Dashboard

Headers

x-grid-environment
string
required

Target Solana environment

Path Parameters

address
string
required

Smart account address

proposal_address
string
required

Proposal address

Query Parameters

showOnChainStatus
boolean

Return raw on-chain proposal status value

Response

Proposal retrieved successfully

data
object
required

Shared response structure for proposal endpoints

metadata
object
required