Returns one proposal with its status and the amounts it moves. After you approve it, read it again after retry_after_ms until that is null; status is then done or failed.
While Circuit is carrying it out, how many milliseconds to wait before reading it again. Null otherwise.
Required range: x >= 0
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Circuit","colors":{"primary":"#6366F1","light":"#818CF8","dark":"#4F46E5"},"logo":{"light":"https://mintcdn.com/selvlabs/8ou4mGHUR7le0P64/images/logo-full-light.svg?fit=max\u0026auto=format\u0026n=8ou4mGHUR7le0P64\u0026q=85\u0026s=2c1db84c637da4973b7f09e617d72421","dark":"https://mintcdn.com/selvlabs/8ou4mGHUR7le0P64/images/logo-full.svg?fit=max\u0026auto=format\u0026n=8ou4mGHUR7le0P64\u0026q=85\u0026s=abff83e9e17fc30cf3885c82a5b28e09"},"favicon":"https://mintcdn.com/selvlabs/8ou4mGHUR7le0P64/images/logo.svg?fit=max\u0026auto=format\u0026n=8ou4mGHUR7le0P64\u0026q=85\u0026s=8be38c888893f7488644fd21ce3c0cc9","api":{"playground":{"proxy":false},"examples":{"prefill":true}},"navbar":{"links":[{"href":"https://circuit.org/articles","label":"Guides"},{"href":"https://circuit.org/strategies","label":"Strategies"}],"primary":{"type":"button","label":"Get Started","href":"https://app.circuit.org"}},"footer":{"socials":{"website":"https://circuit.org","x":"https://x.com/CircuitAI","telegram":"https://t.me/circuitorg"}},"styling":{"codeblocks":{"theme":{"light":"nord","dark":"nord"}},"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"selvlabs","hasAudioNarration":false,"actualSubdomain":"selvlabs","customDomains":["docs.circuit.org"],"gitSource":{"type":"github","owner":"circuitorg","repo":"monorepo","deployBranch":"production","contentDirectory":"docs/public","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af38393d53ec5dcb22d6002","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"Agent Developers","count":32},{"language":"default","tag":"SDK Reference","count":21},{"language":"default","tag":"User Guide","count":21},{"language":"default","tag":"Apps","count":16},{"language":"default","tag":"API Reference","count":10},{"language":"default","tag":"CLI Reference","count":6},{"language":"default","tag":"Getting Started","count":5},{"language":"default","tag":"Using Circuit","count":3},{"language":"default","tag":"Overview","count":1},{"language":"default","tag":"Help","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"[data-component-part=\"field-required-pill\"]{display:none}"}],"page":{"pagePath":"api-reference/get-a-proposal","slug":"/api-reference/get-a-proposal","pageMetadata":{"title":"Get a proposal","description":"Returns one proposal with its status and the amounts it moves. After you approve it, read it again after `retry_after_ms` until that is null; `status` is then `done` or `failed`.","deprecated":null,"version":null,"openapi":"/partner-openapi.gen.json get /partner/v0.1/proposals/{proposal_id}","href":"/api-reference/get-a-proposal","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Returns one proposal with its status and the amounts it moves. After you approve it, read it again after \", _jsx(_components.code, {\n children: \"retry_after_ms\"\n }), \" until that is null; \", _jsx(_components.code, {\n children: \"status\"\n }), \" is then \", _jsx(_components.code, {\n children: \"done\"\n }), \" or \", _jsx(_components.code, {\n children: \"failed\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"nord","dark":"nord"}},"config":{},"pageMetadata":{"title":"Get a proposal","description":"Returns one proposal with its status and the amounts it moves. After you approve it, read it again after `retry_after_ms` until that is null; `status` is then `done` or `failed`.","deprecated":null,"version":null,"openapi":"/partner-openapi.gen.json get /partner/v0.1/proposals/{proposal_id}","href":"/api-reference/get-a-proposal","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getProposal","summary":"Get a proposal","description":"Returns one proposal with its status and the amounts it moves. After you approve it, read it again after `retry_after_ms` until that is null; `status` is then `done` or `failed`.","parameters":["97bff267-c573-456d-864b-0f52279a078c"],"responses":{"200":"4b2c8306-f74b-49e5-af43-612a16ca2b04","default":"7cb956b4-47d4-4d14-ab94-4e011a099f8b"},"security":["7007c12c-43a7-495c-aeb8-f0471d56084d"],"method":"get","type":"path","servers":["0d9efe1a-076d-441c-aff1-87225df6f871"],"path":"/partner/v0.1/proposals/{proposal_id}","baseUrlOptions":["https://api.circuit.org"],"title":"Get a proposal","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[],"disableProxy":true},"dependencies":{"parameters":{"97bff267-c573-456d-864b-0f52279a078c":{"name":"proposal_id","in":"path","required":true,"example":"prop_cd968859-fe26-4c0a-953e-34a3ab68171b","schema":{"type":"string","examples":["prop_cd968859-fe26-4c0a-953e-34a3ab68171b"],"isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"4b2c8306-f74b-49e5-af43-612a16ca2b04":{"description":"OK","content":{"application/json":{"schema":{"description":"Something Ask proposed, such as a trade or an agent start, that waits for your approval.","type":"object","properties":{"id":{"description":"The proposal's id, starting with `prop_`.","type":"string","isRequired":true,"uniqueKey":"id","typeLabel":"string"},"title":{"description":"What it does, starting with a verb, such as \"Buy 0.04 ETH on Lighter\" or \"Start Macro Trend\".","type":"string","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"status":{"oneOf":[{"type":"string","description":"Waiting for you to approve or decline it.","const":"review","isRequired":true,"uniqueKey":"status.oneOf.0","typeLabel":"string"},{"type":"string","description":"Approved, and Circuit is carrying it out.","const":"processing","isRequired":true,"uniqueKey":"status.oneOf.1","typeLabel":"string"},{"type":"string","description":"Carried out.","const":"done","isRequired":true,"uniqueKey":"status.oneOf.2","typeLabel":"string"},{"type":"string","description":"Declined, or it expired before anyone approved it.","const":"declined","isRequired":true,"uniqueKey":"status.oneOf.3","typeLabel":"string"},{"type":"string","description":"It could not be carried out. `error` says why.","const":"failed","isRequired":true,"uniqueKey":"status.oneOf.4","typeLabel":"string"}],"isRequired":true,"uniqueKey":"status","typeLabel":"string"},"amounts":{"description":"The amounts it shows the user on Circuit: what it moves, or for `USD` what it spends or its notional. Empty when it shows none.","type":"array","items":{"description":"One amount a proposal moves.","type":"object","properties":{"amount":{"description":"The amount as a decimal string. Negative when it leaves the wallet in a swap.","type":"string","isRequired":true,"uniqueKey":"amounts.items.[INDEX].amount","typeLabel":"string"},"symbol":{"oneOf":[{"description":"The asset, such as `ETH` or `USDC`, or `USD` for a dollar amount. Null when unknown.","type":"string","uniqueKey":"amounts.items.[INDEX].symbol.oneOf.0","typeLabel":"string"},{"description":"The asset, such as `ETH` or `USDC`, or `USD` for a dollar amount. Null when unknown.","type":"null","uniqueKey":"amounts.items.[INDEX].symbol.oneOf.1","typeLabel":"null"}],"uniqueKey":"amounts.items.[INDEX].symbol","typeLabel":"string | null"},"network":{"oneOf":[{"description":"Where it is, such as `ethereum:8453`, `solana` or `lighter`. Null when unknown.","type":"string","uniqueKey":"amounts.items.[INDEX].network.oneOf.0","typeLabel":"string"},{"description":"Where it is, such as `ethereum:8453`, `solana` or `lighter`. Null when unknown.","type":"null","uniqueKey":"amounts.items.[INDEX].network.oneOf.1","typeLabel":"null"}],"uniqueKey":"amounts.items.[INDEX].network","typeLabel":"string | null"},"value_usd":{"oneOf":[{"description":"Value in USD as a decimal string. Null when Circuit has no value for it.","type":"string","uniqueKey":"amounts.items.[INDEX].value_usd.oneOf.0","typeLabel":"string"},{"description":"Value in USD as a decimal string. Null when Circuit has no value for it.","type":"null","uniqueKey":"amounts.items.[INDEX].value_usd.oneOf.1","typeLabel":"null"}],"uniqueKey":"amounts.items.[INDEX].value_usd","typeLabel":"string | null"}},"required":["amount"],"uniqueKey":"amounts.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"amounts","typeLabel":"object[]"},"error":{"oneOf":[{"description":"Why it failed when `status` is `failed`. Null otherwise.","type":"string","uniqueKey":"error.oneOf.0","typeLabel":"string"},{"description":"Why it failed when `status` is `failed`. Null otherwise.","type":"null","uniqueKey":"error.oneOf.1","typeLabel":"null"}],"uniqueKey":"error","typeLabel":"string | null"},"session":{"oneOf":[{"description":"The session it started or changed, starting with `ses_`. Null for trades.","type":"string","uniqueKey":"session.oneOf.0","typeLabel":"string"},{"description":"The session it started or changed, starting with `ses_`. Null for trades.","type":"null","uniqueKey":"session.oneOf.1","typeLabel":"null"}],"uniqueKey":"session","typeLabel":"string | null"},"retry_after_ms":{"oneOf":[{"description":"While Circuit is carrying it out, how many milliseconds to wait before reading it again. Null otherwise.","type":"integer","format":"uint64","minimum":0,"uniqueKey":"retry_after_ms.oneOf.0","typeLabel":"integer\u003cuint64>"},{"description":"While Circuit is carrying it out, how many milliseconds to wait before reading it again. Null otherwise.","type":"null","format":"uint64","minimum":0,"uniqueKey":"retry_after_ms.oneOf.1","typeLabel":"null"}],"uniqueKey":"retry_after_ms","typeLabel":"integer\u003cuint64> | null"}},"required":["id","title","status","amounts"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"\u003cstring>","title":"\u003cstring>","status":"review","amounts":[{"amount":"\u003cstring>","symbol":"\u003cstring>","network":"\u003cstring>","value_usd":"\u003cstring>"}],"error":"\u003cstring>","session":"\u003cstring>","retry_after_ms":1}}},"exampleType":"generated"}},"exampleType":"generated"},"7cb956b4-47d4-4d14-ab94-4e011a099f8b":{"description":"Failed","content":{"application/json":{"schema":{"description":"A failed call. Handle it by HTTP status and `code`, and show `error` to the user.","type":"object","properties":{"error":{"description":"A message you can show the user.","type":"string","isRequired":true,"uniqueKey":"error","typeLabel":"string"},"code":{"description":"A stable code such as `BAD_REQUEST`, `NOT_FOUND`, `CONFLICT` or `UNAUTHORIZED`. New codes can appear.","type":"string","isRequired":true,"uniqueKey":"code","typeLabel":"string"}},"required":["error","code"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"\u003cstring>","code":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"7007c12c-43a7-495c-aeb8-f0471d56084d":{"permit":{"type":"http","scheme":"bearer","description":"The permit the user approved for your app.","scopes":[],"schemeName":"permit"}}},"servers":{"0d9efe1a-076d-441c-aff1-87225df6f871":{"url":"https://api.circuit.org"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"The permit the user approved for your app.","scopes":[],"schemeName":"permit"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"The permit the user approved for your app.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"permit","name":"Authorization"}],"title":"permit"}]},"originalFileLocation":"partner-openapi.gen.json"},"subdomain":"selvlabs","siteName":"Circuit","title":"Get a proposal - Circuit","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T20:27:53.367Z","originalFileLocation":"api-reference/get-a-proposal.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns one proposal with its status and the amounts it moves. After you approve it, read it again after retry_after_ms until that is null; status is then done or failed.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Circuit\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/selvlabs/XJvZEiKL87V3Fa_3/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/selvlabs/XJvZEiKL87V3Fa_3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/selvlabs/XJvZEiKL87V3Fa_3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/selvlabs/XJvZEiKL87V3Fa_3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/selvlabs/XJvZEiKL87V3Fa_3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/selvlabs/XJvZEiKL87V3Fa_3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/selvlabs/XJvZEiKL87V3Fa_3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/selvlabs/XJvZEiKL87V3Fa_3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/selvlabs/XJvZEiKL87V3Fa_3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a proposal - Circuit\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns one proposal with its status and the amounts it moves. After you approve it, read it again after retry_after_ms until that is null; status is then done or failed.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Circuit\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.circuit.org/api-reference/get-a-proposal\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://selvlabs.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Get+a+proposal\u0026amp;description=Returns+one+proposal+with+its+status+and+the+amounts+it+moves.+After+you+approve+it%2C+read+it+again+after+%60retry_after_ms%60+until+that+is+null%3B+%60status%60+is+then+%60\u0026amp;theme=24f98e456ba48ac2f3578124\u0026amp;signature=b70f081971cf819c25ce1168ac31502bc38c68a59cae2b6d6519089d7a969b46\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a proposal - Circuit\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns one proposal with its status and the amounts it moves. After you approve it, read it again after retry_after_ms until that is null; status is then done or failed.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://selvlabs.mintlify.site/_mintlify/api/og/v2?division=API+Reference\u0026amp;title=Get+a+proposal\u0026amp;description=Returns+one+proposal+with+its+status+and+the+amounts+it+moves.+After+you+approve+it%2C+read+it+again+after+%60retry_after_ms%60+until+that+is+null%3B+%60status%60+is+then+%60\u0026amp;theme=24f98e456ba48ac2f3578124\u0026amp;signature=b70f081971cf819c25ce1168ac31502bc38c68a59cae2b6d6519089d7a969b46\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/selvlabs/XJvZEiKL87V3Fa_3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Circuit\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6366F1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.circuit.org/api-reference/get-a-proposal\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/get-a-proposal.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.circuit.org/#organization\",\"name\":\"Circuit\",\"url\":\"https://docs.circuit.org\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/selvlabs/8ou4mGHUR7le0P64/images/logo-full-light.svg?fit=max\u0026auto=format\u0026n=8ou4mGHUR7le0P64\u0026q=85\u0026s=2c1db84c637da4973b7f09e617d72421\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.circuit.org#website\",\"name\":\"Circuit\",\"url\":\"https://docs.circuit.org\",\"publisher\":{\"@id\":\"https://docs.circuit.org/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.circuit.org/api-reference/get-a-proposal#webpage\",\"url\":\"https://docs.circuit.org/api-reference/get-a-proposal\",\"name\":\"Get a proposal\",\"description\":\"Returns one proposal with its status and the amounts it moves. After you approve it, read it again after retry_after_ms until that is null; status is then done or failed.\",\"dateModified\":\"2026-11-10T20:27:53.367Z\",\"isPartOf\":{\"@id\":\"https://docs.circuit.org#website\"},\"breadcrumb\":{\"@id\":\"https://docs.circuit.org/api-reference/get-a-proposal#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.circuit.org/api-reference/get-a-proposal#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Apps\",\"item\":\"https://docs.circuit.org/apps\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"API Reference\",\"item\":\"https://docs.circuit.org/api-reference/get-the-users-account\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get a proposal\",\"item\":\"https://docs.circuit.org/api-reference/get-a-proposal\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.circuit.org/api-reference/get-a-proposal#apireference\",\"headline\":\"Get a proposal\",\"name\":\"Get a proposal\",\"description\":\"Returns one proposal with its status and the amounts it moves. After you approve it, read it again after retry_after_ms until that is null; status is then done or failed.\",\"url\":\"https://docs.circuit.org/api-reference/get-a-proposal\",\"mainEntityOfPage\":{\"@id\":\"https://docs.circuit.org/api-reference/get-a-proposal#webpage\"},\"dateModified\":\"2026-11-10T20:27:53.367Z\",\"publisher\":{\"@id\":\"https://docs.circuit.org/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.circuit.org#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Circuit\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Circuit\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/get-a-proposal.md","siteName":"Circuit","nav":{"global":null,"tabs":[{"tab":"User Guide","groups":[{"group":"Overview","pages":[{"title":"Agentic Trading","href":"/introduction"}]},{"group":"Using Circuit","pages":[{"title":"Get Started","href":"/agent-users/get-started"},{"title":"Running Agents","href":"/agent-users/running-agents"},{"title":"Wallets \u0026 Security","href":"/agent-users/wallets-and-security"}]},{"group":"Apps","pages":[{"title":"Build Circuit into your app","href":"/apps"},{"title":"Quickstart","href":"/apps-quickstart"},{"title":"Test with paper money","href":"/apps-testing"},{"title":"Concepts","href":"/apps-concepts"},{"title":"Reference client","href":"/apps-client"},{"title":"Webhook providers","href":"/webhooks"},{"group":"API Reference","pages":[{"title":"Get the user's account","deprecated":null,"version":null,"openapi":"/partner-openapi.gen.json get /partner/v0.1/account","href":"/api-reference/get-the-users-account"},{"title":"List agents","deprecated":null,"version":null,"openapi":"/partner-openapi.gen.json get /partner/v0.1/agents","href":"/api-reference/list-agents"},{"title":"Start an agent","deprecated":null,"version":null,"openapi":"/partner-openapi.gen.json post /partner/v0.1/sessions","href":"/api-reference/start-an-agent"},{"title":"Add money to an agent","deprecated":null,"version":null,"openapi":"/partner-openapi.gen.json post /partner/v0.1/sessions/{session_id}/top_up","href":"/api-reference/add-money-to-an-agent"},{"title":"Stop an agent","deprecated":null,"version":null,"openapi":"/partner-openapi.gen.json post /partner/v0.1/sessions/{session_id}/stop","href":"/api-reference/stop-an-agent"},{"title":"Send a message","deprecated":null,"version":null,"openapi":"/partner-openapi.gen.json post /partner/v0.1/messages","href":"/api-reference/send-a-message"},{"title":"Get a chat","description":"Returns every message in a chat with Ask's replies and proposals. While `retry_after_ms` is set, Ask is still working or a proposal is being carried out; read the chat again after that many milliseconds.","deprecated":null,"version":null,"openapi":"/partner-openapi.gen.json get /partner/v0.1/chats/{chat_id}","href":"/api-reference/get-a-chat"},{"title":"Get a proposal","deprecated":null,"version":null,"openapi":"/partner-openapi.gen.json get /partner/v0.1/proposals/{proposal_id}","href":"/api-reference/get-a-proposal"},{"title":"Approve or decline a proposal","description":"Approves or declines something Ask proposed. Approve only after the user agrees in your app. Sending the same decision again returns the proposal unchanged; the opposite decision on a settled proposal returns 409.","deprecated":null,"version":null,"openapi":"/partner-openapi.gen.json post /partner/v0.1/proposals/{proposal_id}","href":"/api-reference/approve-or-decline-a-proposal"},{"title":"Unlink the user","deprecated":null,"version":null,"openapi":"/partner-openapi.gen.json delete /partner/v0.1/permit","href":"/api-reference/unlink-the-user"}]}]},{"group":"Help","pages":[{"title":"Support","href":"/support"}]}]},{"tab":"Agent Developers","pages":[{"title":"Agent Developers","href":"/agent-developers/overview"}]}]},"basePath":"","title":"Get a proposal - Circuit","buildId":"dpl_596ePT575z4qnAFksq1biRW97aLY","deploymentId":"dpl_596ePT575z4qnAFksq1biRW97aLY","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C9Wu0MeN.js","utils-jWgu-6Qf.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DBD8f9qn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-BGuX1ui5.js","snippetPresets-Evy63nQB.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BQHO1lnV.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-B6C8m-t_.js","shallow-BG4cT0fH.js","getApiPlaygroundDisplay-CgEPrE-D.js","CodeSnippet-CU8JyZ9N.js","CodeSnippets-BnxHU32T.js","Page-D6S0Yh6q.js","getPastedJson-CwiYOonh.js","icon-DYDpWmDf.js","MethodPill-C-J-l7_c.js","DuplicateIcon-B6ARwg9w.js","createIcon-Dsv4MtDq.js","DynamicMarkdown-CtasenyM.js","SectionHeading-YNcgYwjB.js","axios-vUo_bRtp.js","Markdown-CwLx6PAg.js","clsx-C3kuh_dz.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CmKHfscc.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-U3mI6Ljh.js"]}