# GET: /proposal/:proposalId ## GET: /proposal/:proposalId ### ProposalResponse The API response provides detailed governance proposal data for the specified proposal ID. Response Structure

Type	Key	Description
Struct	`metadata`	Metadata on the request (empty for this request)
Struct	`data`	Proposal details (see `Proposal` below)

### Proposal Object A detailed structure representing a governance proposal.

Type	Key	Description
uint32	`id`	Unique ID for the proposal
string	`description`	Description of proposed actions
bytes	`targets`	Address receiving calldata
string	`values`	ETH value sent with the transaction
string	`signatures`	Function signature for execution
string	`call_datas`	Encoded function arguments
Struct	`params`	Additional parameters
uint32	`created_Block`	Block number where proposal was created
string	`created_tx_Hash`	Transaction hash of proposal creation
uint32	`created_timestamp`	Timestamp of proposal creation
uint32	`start_block`	Block number when voting starts
string	`start_tx_hash`	Transaction hash of vote initiation
uint32	`start_timestamp`	Timestamp of vote initiation
uint32	`cancel_block`	Block number of cancellation (if applicable)
string	`cancel_tx_hash`	Transaction hash of cancellation
uint32	`cancel_timestamp`	Timestamp of cancellation
uint32	`end_block`	Block number when voting ends
string	`end_tx_hash`	Transaction hash of vote conclusion
uint32	`end_timestamp`	Timestamp of vote conclusion
uint32	`queued_block`	Block number when proposal was queued
string	`queued_tx_hash`	Transaction hash of queueing
uint32	`queued_timestamp`	Timestamp when proposal was queued
uint32	`executed_block`	Block number when proposal was executed
string	`executed_tx_hash`	Transaction hash of execution
uint32	`executed_timestamp`	Timestamp of execution
bytes	`for_votes`	Number of votes in favor
bytes	`against_votes`	Number of votes against
bytes	`proposer`	Address of the proposer
uint32	`eta`	Estimated execution time
string	`forVotes`	String representation of votes in favor
string	`againstVotes`	String representation of votes against
uint32	`canceled`	1 if canceled, 0 otherwise
uint32	`executed`	1 if executed, 0 otherwise
string	`state`	Current proposal state (`Pending`, `Active`, `Canceled`, `Defeated`, `Succeeded`, `Queued`, `Expired`, `Executed`)
uint32	`voter_count`	Total number of voters
Timestamp	`created_at`	Proposal creation timestamp
Timestamp	`updated_at`	Proposal last updated timestamp
uint32	`expired_timestamp`	Timestamp when proposal expires
string	`title`	Proposal title

#### Usage Notes * Retrieving Proposal Details: Use this endpoint to fetch detailed information on a specific proposal using its unique proposal ID. * Tracking Proposal Progress: The response provides full lifecycle tracking, from proposal creation to execution or expiration. * Filtering by Proposal State: The state field can be used to filter and categorize proposals into active, executed, canceled, or expired states. * Proposal Monitoring: Voting activity and execution timestamps allow for real-time proposal tracking. --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.onyx.org/api/get-proposal-proposalid.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.