> ## Documentation Index > Fetch the complete documentation index at: https://docs.mls.onchainden.com/llms.txt > Use this file to discover all available pages before exploring further. # Get an account proposal > Returns a single account proposal by its unique identifier. ## OpenAPI ````yaml /openapi.yaml get /accounts/proposals/{proposalId} openapi: 3.1.0 info: title: Den API version: 2.0.0 description: > API for managing wallets with Den. This API provides programmatic access to all platform capabilities including wallet accounts, members, groups, policies, and transactions. ## Authentication All API requests require authentication via Bearer token in the Authorization header. ## Idempotency All mutation requests (POST, PUT, DELETE) require an X-Idempotency-Key header for safe retries. ## Two Transaction Types - **Account Transactions**: Value movement and contract interactions (governed by policies) - **Organization Operations**: Governance/admin changes (governed by admin threshold) servers: - url: https://api.onchainden.com/api/v1 description: Production security: - bearerAuth: [] tags: - name: Members description: Manage organization members - name: Groups description: Manage member groups - name: Policies description: Manage transaction policies - name: Accounts description: Manage wallet accounts - name: Transactions description: Create and execute account transactions - name: Admins description: Manage admin configuration - name: AuditLogs description: View audit log entries paths: /accounts/proposals/{proposalId}: get: tags: - Accounts summary: Get an account proposal description: Returns a single account proposal by its unique identifier. operationId: getAccountProposal parameters: - name: proposalId in: path required: true schema: type: string responses: '200': description: Account proposal details content: application/json: schema: type: object required: - data properties: data: $ref: '#/components/schemas/OrganizationOperationAccounts' '401': $ref: '#/components/responses/Unauthorized' '404': $ref: '#/components/responses/NotFound' x-codeSamples: - lang: javascript label: SDK source: | const client = new DenClient({ apiKey: 'ck_live_...' }); const proposal = await client.getAccountProposal('prop_123'); components: schemas: OrganizationOperationAccounts: oneOf: - allOf: - $ref: '#/components/schemas/OrganizationOperationAccountsCreate' title: Accounts Create - allOf: - $ref: '#/components/schemas/OrganizationOperationAccountsUpdate' title: Accounts Update OrganizationOperationAccountsCreate: allOf: - $ref: '#/components/schemas/OrganizationOperationBase' - type: object properties: resourceType: type: string const: accounts action: type: string const: create data: $ref: '#/components/schemas/AccountCreateProposalData' example: id: prop_acc_create_123 resourceType: accounts action: create signatureStatus: approvalReady executionStatus: completed threshold: 2 approvals: [] rejections: [] createdAt: '2026-01-18T00:00:00.000Z' expiresAt: '2026-01-25T00:00:00.000Z' data: items: - name: Treasury networkIds: - 1 - 137 result: resolution: approved resources: - type: account id: acc_new1 uri: /api/v1/accounts/acc_new1 OrganizationOperationAccountsUpdate: allOf: - $ref: '#/components/schemas/OrganizationOperationBase' - type: object properties: resourceType: type: string const: accounts action: type: string const: update data: $ref: '#/components/schemas/AccountUpdateProposalData' example: id: prop_acc_update_123 resourceType: accounts action: update signatureStatus: approvalReady executionStatus: completed threshold: 2 approvals: [] rejections: [] createdAt: '2026-01-18T00:00:00.000Z' expiresAt: '2026-01-25T00:00:00.000Z' data: items: - id: acc_123 name: Main Treasury - id: acc_456 networkIds: - 42161 result: resolution: approved resources: - type: account id: acc_123 uri: /api/v1/accounts/acc_123 - type: account id: acc_456 uri: /api/v1/accounts/acc_456 Error: type: object required: - error properties: error: $ref: '#/components/schemas/ErrorObject' OrganizationOperationBase: type: object required: - id - resourceType - action - signatureStatus - executionStatus - threshold - approvals - rejections - createdAt - expiresAt - data properties: id: type: string example: prop_abc resourceType: $ref: '#/components/schemas/ResourceType' action: $ref: '#/components/schemas/ProposalAction' signatureStatus: $ref: '#/components/schemas/SignatureStatus' executionStatus: $ref: '#/components/schemas/ExecutionStatus' threshold: type: integer example: 2 approvals: type: array items: $ref: '#/components/schemas/MemberSummary' rejections: type: array items: $ref: '#/components/schemas/MemberSummary' createdAt: type: string format: date-time expiresAt: type: string format: date-time data: description: Proposed resource state after execution. signingPayloads: $ref: '#/components/schemas/ReviewSigningPayloads' description: >- Present only while signatures can still be collected for non-expired organization operations result: $ref: '#/components/schemas/OrganizationOperationResult' description: Present only after execution AccountCreateProposalData: type: object required: - items properties: items: type: array items: $ref: '#/components/schemas/AccountCreateItem' AccountUpdateProposalData: type: object required: - items properties: items: type: array items: $ref: '#/components/schemas/AccountUpdateItem' ErrorObject: type: object required: - code - message properties: code: $ref: '#/components/schemas/ErrorCode' message: type: string description: Human-readable error message details: $ref: '#/components/schemas/ErrorDetails' ResourceType: type: string enum: - members - groups - policies - accounts - admins ProposalAction: type: string enum: - create - update - remove - delete SignatureStatus: type: string enum: - pendingInitiatorSignature - pendingReviewSignatures - approvalReady - rejectionReady - approvalAndRejectionReady - expired description: > Current signature state in the approval workflow: - pendingInitiatorSignature: Account Transactions only - awaiting initiator signature - pendingReviewSignatures: Neither approval nor rejection threshold met - approvalReady: Approval threshold met, rejection not met - rejectionReady: Rejection threshold met, approval not met - approvalAndRejectionReady: Both thresholds met, either can be executed - expired: Proposal expired before execution ExecutionStatus: type: string nullable: true enum: - null - processing - completed - rejected - failed - blocked description: | Execution lifecycle state: - null: Not yet attempted - processing: Execution in progress - completed: Successfully executed - rejected: Successfully rejected - failed: Execution failed - blocked: Blocked by policy or constraint MemberSummary: type: object description: Abbreviated member info used in approvals/rejections arrays required: - id - name - type - walletAddress properties: id: type: string example: mem_123 name: type: string example: Alice type: $ref: '#/components/schemas/MemberType' walletAddress: type: string pattern: ^0x[a-fA-F0-9]{40}$ ReviewSigningPayloads: type: object required: - approvePayload - rejectPayload properties: approvePayload: type: string description: Payload for approval signature rejectPayload: type: string description: Payload for rejection signature OrganizationOperationResult: type: object required: - resolution properties: resolution: type: string enum: - approved - rejected description: Final outcome of the proposal execution resources: type: array items: $ref: '#/components/schemas/OrganizationOperationResultResource' description: Resources created or modified. Empty when rejected. AccountCreateItem: type: object required: - name - networkIds properties: name: type: string example: Treasury networkIds: type: array items: $ref: '#/components/schemas/NetworkId' example: - 1 - 137 AccountUpdateItem: type: object required: - id properties: id: type: string example: acc_123 name: type: string example: Main Treasury networkIds: type: array items: $ref: '#/components/schemas/NetworkId' description: Network IDs to add to the account ErrorCode: type: string enum: - validationError - invalidSignature - unauthorized - forbidden - notFound - conflict - thresholdNotMet - proposalExpired - idempotencyConflict - upgradeRequired - rateLimited - internalError description: Machine-readable error codes ErrorDetails: type: object additionalProperties: true description: Additional error details (structure varies by error type) properties: field: type: string description: Field that caused the error (for validation errors) message: type: string description: Detailed message about the error MemberType: type: string enum: - user - api description: Type of member (user for human members, api for bots) OrganizationOperationResultResource: type: object required: - type - id properties: type: type: string description: Resource type that was created, updated, or removed example: member id: type: string description: Unique identifier of the affected resource example: mem_new1 uri: type: string description: >- Canonical URI for the affected resource (omitted for removals/deletes) example: /api/v1/members/mem_new1 NetworkId: type: integer example: 1 description: Network chain ID responses: Unauthorized: description: API key is missing or invalid content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: unauthorized message: Invalid API key NotFound: description: Resource not found content: application/json: schema: $ref: '#/components/schemas/Error' example: error: code: notFound message: Resource not found securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Key description: >- API key authentication. Include your API key in the Authorization header. ````