Read authoritative purchase status immediately by default.
get_purchaseEarly accessRead only
This tool is in early access. It is available at https://mcp.tuyo.com/mcp-early-access to accounts with Pods early access. See Early access.
Description
The model reads this text to decide when and how to call the tool.
Read authoritative purchase status immediately by default. Optional waitSeconds 1–25 waits for active readiness or a terminal state; pending approval and accepted preparation both wait. Calls share a total stopping deadline of creation plus five minutes, capped by effective expiry. A timeout means still waiting, never rejection or creation failure. Stale observations retain their original observation time. Managed purchases require fresh managerIdentity from the original signer; reading remains possible after grant revocation as supported by the API. An event is a reason to read status, never permission to pay twice.
Input
string
required
Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.
string
Fresh identity token from the original tuyo-signer key. This credential maps to the existing Tuyo-Agent-Identity header; never put it in reason or conversation.
integer
default:"0"
required
Immediate read by default (0); 1–25 waits for active readiness or a terminal state. Pending and accepted both wait. Total automatic waiting ends at creation plus five minutes, capped by effective expiry; calls never reset it.
string
Optional short explanation of the user goal. Do not include secrets or full addresses.
Output
The structured result is { data, meta }. meta has the requestId and the asOf time. These are the fields of data. An error returns { error, meta }; see Errors.
object
required
Show properties
string
required
enum
required
One of: pending, rejected, accepted, active, charged, expired, failed, canceled.
string
required
string
required
string
required
Can be null.
string
required
Can be null.
string
required
string
required
string
required
string
required
string
required
object
required
Can be null.
Show properties
enum
required
One of: amount_over_approved, insufficient_funds, limit_exceeded, merchant_not_supported, card_unavailable, other.
string
required
string
Can be null.
enum
required
One of: user_approval, management, unknown.
object[]
Can be null.
object
required
Show kind: main
"main"
required
Show kind: pod
"pod"
required
string
required
Show kind: unknown
"unknown"
required
object
required
Show kind: review_in_tuyo
"review_in_tuyo"
required
string
required
Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.
Show kind: get_purchase
"get_purchase"
required
string
required
Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.
integer
required
Show kind: get_purchase_payment_details
"get_purchase_payment_details"
required
string
required
Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.
Show kind: inspect_decline
"inspect_decline"
required
string
required
Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.
Show kind: reconcile_payment
"reconcile_payment"
required
string
required
Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.
Show kind: inspect_state
"inspect_state"
required
string
required
Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.
Show kind: stop_waiting
"stop_waiting"
required
string
required
Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.
Show kind: replacement_if_still_requested
"replacement_if_still_requested"
required
enum
required
One of: user_approval, management, unknown.
string
required
Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.
Show kind: complete_cancellation
"complete_cancellation"
required
string
required
Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.
integer
required
Show kind: stop
"stop"
required
string[]
required
string
object
required
Show properties
string
required
boolean
required
object
required
Show properties
enum
required
One of: immediate, ready, terminal, timeout, stopping.
string
required
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Tuyo","description":"Connect Tuyo to an AI. Read your money and act on it from a conversation.","colors":{"primary":"#2F7D1E","light":"#9AEA63","dark":"#2F7D1E"},"logo":{"light":"/images/logo.svg","dark":"/images/logo.svg","href":"https://tuyo.com"},"favicon":"/images/favicon.svg","background":{"color":{"dark":"#0A1015"}},"navbar":{"links":[{"href":"https://help.tuyo.com","label":"Support"}],"primary":{"type":"button","label":"Get Tuyo","href":"https://tuyo.com"}},"footer":{"socials":{"github":"https://github.com/tuyoinc"}},"contextual":{"options":["copy","view","chatgpt","claude","cursor","vscode"],"display":"header"},"integrations":{"telemetry":{"enabled":false}},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"hasAudioNarration":false,"customDomains":[],"gitSource":{"type":"github","owner":"local","repo":"local","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":"local","isBase":true},"buildId":"local","clientVersion":"0.0.4226"},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false,"isLoggedInCli":false,"mintExport":{}},"customCss":[{"filePath":"style.css","content":".tool-description{border-left:3px solid rgb(var(--primary-light));padding-left:1rem;font-size:0.9rem;opacity:0.9}"}]}
{"page":{"pagePath":"tools/get_purchase","slug":"/tools/get_purchase","pageMetadata":{"title":"Read purchase readiness","sidebarTitle":"get_purchase","description":"Read authoritative purchase status immediately by default.","href":"/tools/get_purchase"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Read authoritative purchase status immediately by default.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,p:`p`,..._provideComponents(),...props.components},{Badge,Expandable,Heading,Note,ParamField,ResponseField}=_components;if(!Badge)_missingMdxReference(`Badge`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Note)_missingMdxReference(`Note`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[`\n`,_jsxs(_components.p,{children:[_jsx(_components.code,{children:`get_purchase`}),` `,_jsx(Badge,{color:`orange`,children:`Early access`}),` `,_jsx(Badge,{color:`blue`,children:`Read only`})]}),`\n`,_jsxs(Note,{children:[`This tool is in early access. It is available at `,_jsx(_components.code,{children:`https://mcp.tuyo.com/mcp-early-access`}),` to accounts with Pods early access. See `,_jsx(_components.a,{href:`/early-access`,children:`Early access`}),`.`]}),`\n`,_jsx(Heading,{level:`2`,id:`description`,children:`Description`}),`\n`,_jsx(_components.p,{children:`The model reads this text to decide when and how to call the tool.`}),`\n`,_jsx(`div`,{className:`tool-description`,children:_jsx(_components.p,{children:`Read authoritative purchase status immediately by default. Optional waitSeconds 1–25 waits for active readiness or a terminal state; pending approval and accepted preparation both wait. Calls share a total stopping deadline of creation plus five minutes, capped by effective expiry. A timeout means still waiting, never rejection or creation failure. Stale observations retain their original observation time. Managed purchases require fresh managerIdentity from the original signer; reading remains possible after grant revocation as supported by the API. An event is a reason to read status, never permission to pay twice.`})}),`\n`,_jsx(Heading,{level:`2`,id:`input`,children:`Input`}),`\n`,_jsx(ParamField,{body:`purchaseIntentId`,type:`string`,required:true,id:`param-purchase-intent-id`,children:_jsx(_components.p,{children:`Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.`})}),`\n`,_jsx(ParamField,{body:`managerIdentity`,type:`string`,id:`param-manager-identity`,children:_jsx(_components.p,{children:`Fresh identity token from the original tuyo-signer key. This credential maps to the existing Tuyo-Agent-Identity header; never put it in reason or conversation.`})}),`\n`,_jsx(ParamField,{body:`waitSeconds`,type:`integer`,required:true,default:`0`,id:`param-wait-seconds`,children:_jsx(_components.p,{children:`Immediate read by default (0); 1–25 waits for active readiness or a terminal state. Pending and accepted both wait. Total automatic waiting ends at creation plus five minutes, capped by effective expiry; calls never reset it.`})}),`\n`,_jsx(ParamField,{body:`reason`,type:`string`,id:`param-reason`,children:_jsx(_components.p,{children:`Optional short explanation of the user goal. Do not include secrets or full addresses.`})}),`\n`,_jsx(Heading,{level:`2`,id:`output`,children:`Output`}),`\n`,_jsxs(_components.p,{children:[`The structured result is `,_jsx(_components.code,{children:`{ data, meta }`}),`. `,_jsx(_components.code,{children:`meta`}),` has the `,_jsx(_components.code,{children:`requestId`}),` and the `,_jsx(_components.code,{children:`asOf`}),` time. These are the fields of `,_jsx(_components.code,{children:`data`}),`. An error returns `,_jsx(_components.code,{children:`{ error, meta }`}),`; see `,_jsx(_components.a,{href:`/guides/errors`,children:`Errors`}),`.`]}),`\n`,_jsx(ResponseField,{name:`purchase`,type:`object`,required:true,id:`param-purchase`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`id`,type:`string`,required:true,id:`param-id`}),_jsx(ResponseField,{name:`status`,type:`enum`,required:true,id:`param-status`,children:_jsxs(_components.p,{children:[`One of: `,_jsx(_components.code,{children:`pending`}),`, `,_jsx(_components.code,{children:`rejected`}),`, `,_jsx(_components.code,{children:`accepted`}),`, `,_jsx(_components.code,{children:`active`}),`, `,_jsx(_components.code,{children:`charged`}),`, `,_jsx(_components.code,{children:`expired`}),`, `,_jsx(_components.code,{children:`failed`}),`, `,_jsx(_components.code,{children:`canceled`}),`.`]})}),_jsx(ResponseField,{name:`title`,type:`string`,required:true,id:`param-title`}),_jsx(ResponseField,{name:`merchant`,type:`string`,required:true,id:`param-merchant`}),_jsx(ResponseField,{name:`description`,type:`string`,required:true,id:`param-description`,children:_jsxs(_components.p,{children:[`Can be `,_jsx(_components.code,{children:`null`}),`.`]})}),_jsx(ResponseField,{name:`checkoutUrl`,type:`string`,required:true,id:`param-checkout-url`,children:_jsxs(_components.p,{children:[`Can be `,_jsx(_components.code,{children:`null`}),`.`]})}),_jsx(ResponseField,{name:`amount`,type:`string`,required:true,id:`param-amount`}),_jsx(ResponseField,{name:`currency`,type:`string`,required:true,id:`param-currency`}),_jsx(ResponseField,{name:`usdAmount`,type:`string`,required:true,id:`param-usd-amount`}),_jsx(ResponseField,{name:`expiresAt`,type:`string`,required:true,id:`param-expires-at`}),_jsx(ResponseField,{name:`createdAt`,type:`string`,required:true,id:`param-created-at`}),_jsxs(ResponseField,{name:`lastDecline`,type:`object`,required:true,id:`param-last-decline`,children:[_jsxs(_components.p,{children:[`Can be `,_jsx(_components.code,{children:`null`}),`.`]}),_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`reason`,type:`enum`,required:true,id:`param-reason-1`,children:_jsxs(_components.p,{children:[`One of: `,_jsx(_components.code,{children:`amount_over_approved`}),`, `,_jsx(_components.code,{children:`insufficient_funds`}),`, `,_jsx(_components.code,{children:`limit_exceeded`}),`, `,_jsx(_components.code,{children:`merchant_not_supported`}),`, `,_jsx(_components.code,{children:`card_unavailable`}),`, `,_jsx(_components.code,{children:`other`}),`.`]})}),_jsx(ResponseField,{name:`declinedAt`,type:`string`,required:true,id:`param-declined-at`})]})]}),_jsx(ResponseField,{name:`fromAccountId`,type:`string`,id:`param-from-account-id`,children:_jsxs(_components.p,{children:[`Can be `,_jsx(_components.code,{children:`null`}),`.`]})}),_jsx(ResponseField,{name:`approvalPath`,type:`enum`,required:true,id:`param-approval-path`,children:_jsxs(_components.p,{children:[`One of: `,_jsx(_components.code,{children:`user_approval`}),`, `,_jsx(_components.code,{children:`management`}),`, `,_jsx(_components.code,{children:`unknown`}),`.`]})}),_jsx(ResponseField,{name:`transactionReferences`,type:`object[]`,id:`param-transaction-references`,children:_jsxs(_components.p,{children:[`Can be `,_jsx(_components.code,{children:`null`}),`.`]})})]})}),`\n`,_jsxs(ResponseField,{name:`scope`,type:`object`,required:true,id:`param-scope`,children:[_jsx(Expandable,{title:`kind: main`,children:_jsx(ResponseField,{name:`kind`,type:`\"main\"`,required:true,id:`param-kind`})}),_jsxs(Expandable,{title:`kind: pod`,children:[_jsx(ResponseField,{name:`kind`,type:`\"pod\"`,required:true,id:`param-kind-1`}),_jsx(ResponseField,{name:`accountId`,type:`string`,required:true,id:`param-account-id`})]}),_jsx(Expandable,{title:`kind: unknown`,children:_jsx(ResponseField,{name:`kind`,type:`\"unknown\"`,required:true,id:`param-kind-2`})})]}),`\n`,_jsxs(ResponseField,{name:`nextAction`,type:`object`,required:true,id:`param-next-action`,children:[_jsxs(Expandable,{title:`kind: review_in_tuyo`,children:[_jsx(ResponseField,{name:`kind`,type:`\"review_in_tuyo\"`,required:true,id:`param-kind-3`}),_jsx(ResponseField,{name:`purchaseIntentId`,type:`string`,required:true,id:`param-purchase-intent-id-1`,children:_jsx(_components.p,{children:`Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.`})})]}),_jsxs(Expandable,{title:`kind: get_purchase`,children:[_jsx(ResponseField,{name:`kind`,type:`\"get_purchase\"`,required:true,id:`param-kind-4`}),_jsx(ResponseField,{name:`purchaseIntentId`,type:`string`,required:true,id:`param-purchase-intent-id-2`,children:_jsx(_components.p,{children:`Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.`})}),_jsx(ResponseField,{name:`waitSeconds`,type:`integer`,required:true,id:`param-wait-seconds-1`})]}),_jsxs(Expandable,{title:`kind: get_purchase_payment_details`,children:[_jsx(ResponseField,{name:`kind`,type:`\"get_purchase_payment_details\"`,required:true,id:`param-kind-5`}),_jsx(ResponseField,{name:`purchaseIntentId`,type:`string`,required:true,id:`param-purchase-intent-id-3`,children:_jsx(_components.p,{children:`Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.`})})]}),_jsxs(Expandable,{title:`kind: inspect_decline`,children:[_jsx(ResponseField,{name:`kind`,type:`\"inspect_decline\"`,required:true,id:`param-kind-6`}),_jsx(ResponseField,{name:`purchaseIntentId`,type:`string`,required:true,id:`param-purchase-intent-id-4`,children:_jsx(_components.p,{children:`Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.`})})]}),_jsxs(Expandable,{title:`kind: reconcile_payment`,children:[_jsx(ResponseField,{name:`kind`,type:`\"reconcile_payment\"`,required:true,id:`param-kind-7`}),_jsx(ResponseField,{name:`purchaseIntentId`,type:`string`,required:true,id:`param-purchase-intent-id-5`,children:_jsx(_components.p,{children:`Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.`})})]}),_jsxs(Expandable,{title:`kind: inspect_state`,children:[_jsx(ResponseField,{name:`kind`,type:`\"inspect_state\"`,required:true,id:`param-kind-8`}),_jsx(ResponseField,{name:`purchaseIntentId`,type:`string`,required:true,id:`param-purchase-intent-id-6`,children:_jsx(_components.p,{children:`Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.`})})]}),_jsxs(Expandable,{title:`kind: stop_waiting`,children:[_jsx(ResponseField,{name:`kind`,type:`\"stop_waiting\"`,required:true,id:`param-kind-9`}),_jsx(ResponseField,{name:`purchaseIntentId`,type:`string`,required:true,id:`param-purchase-intent-id-7`,children:_jsx(_components.p,{children:`Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.`})})]}),_jsxs(Expandable,{title:`kind: replacement_if_still_requested`,children:[_jsx(ResponseField,{name:`kind`,type:`\"replacement_if_still_requested\"`,required:true,id:`param-kind-10`}),_jsx(ResponseField,{name:`approvalPath`,type:`enum`,required:true,id:`param-approval-path-1`,children:_jsxs(_components.p,{children:[`One of: `,_jsx(_components.code,{children:`user_approval`}),`, `,_jsx(_components.code,{children:`management`}),`, `,_jsx(_components.code,{children:`unknown`}),`.`]})}),_jsx(ResponseField,{name:`purchaseIntentId`,type:`string`,required:true,id:`param-purchase-intent-id-8`,children:_jsx(_components.p,{children:`Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.`})})]}),_jsxs(Expandable,{title:`kind: complete_cancellation`,children:[_jsx(ResponseField,{name:`kind`,type:`\"complete_cancellation\"`,required:true,id:`param-kind-11`}),_jsx(ResponseField,{name:`purchaseIntentId`,type:`string`,required:true,id:`param-purchase-intent-id-9`,children:_jsx(_components.p,{children:`Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.`})}),_jsx(ResponseField,{name:`retryAfterSeconds`,type:`integer`,required:true,id:`param-retry-after-seconds`})]}),_jsx(Expandable,{title:`kind: stop`,children:_jsx(ResponseField,{name:`kind`,type:`\"stop\"`,required:true,id:`param-kind-12`})})]}),`\n`,_jsx(ResponseField,{name:`interpretation`,type:`string[]`,required:true,id:`param-interpretation`}),`\n`,_jsx(ResponseField,{name:`cardEncryptionPublicKey`,type:`string`,id:`param-card-encryption-public-key`}),`\n`,_jsx(ResponseField,{name:`observation`,type:`object`,required:true,id:`param-observation`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`observedAt`,type:`string`,required:true,id:`param-observed-at`}),_jsx(ResponseField,{name:`stale`,type:`boolean`,required:true,id:`param-stale`})]})}),`\n`,_jsx(ResponseField,{name:`wait`,type:`object`,required:true,id:`param-wait`,children:_jsxs(Expandable,{title:`properties`,children:[_jsx(ResponseField,{name:`outcome`,type:`enum`,required:true,id:`param-outcome`,children:_jsxs(_components.p,{children:[`One of: `,_jsx(_components.code,{children:`immediate`}),`, `,_jsx(_components.code,{children:`ready`}),`, `,_jsx(_components.code,{children:`terminal`}),`, `,_jsx(_components.code,{children:`timeout`}),`, `,_jsx(_components.code,{children:`stopping`}),`.`]})}),_jsx(ResponseField,{name:`automaticWaitDeadline`,type:`string`,required:true,id:`param-automatic-wait-deadline`})]})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Read purchase readiness","sidebarTitle":"get_purchase","description":"Read authoritative purchase status immediately by default.","href":"/tools/get_purchase"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Description","slug":"description","depth":2,"children":[]},{"title":"Input","slug":"input","depth":2,"children":[]},{"title":"Output","slug":"output","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"localhost","siteName":"Tuyo","title":"Read purchase readiness - Tuyo","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"tools/get_purchase.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=\"Read authoritative purchase status immediately by default.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Tuyo\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/favicons/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/favicons/favicon-32x32.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/favicons/favicon-16x16.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/favicons/favicon.ico\">\u003cmeta data-mint-head property=\"og:title\" content=\"Read purchase readiness - Tuyo\">\u003cmeta data-mint-head property=\"og:description\" content=\"Read authoritative purchase status immediately by default.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Tuyo\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://local./tools/get_purchase\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Read purchase readiness - Tuyo\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Read authoritative purchase status immediately by default.\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/favicons/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Tuyo\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2F7D1E\">\u003clink data-mint-head rel=\"canonical\" href=\"https://local./tools/get_purchase\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/tools/get_purchase.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Tuyo\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Tuyo\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/tools/get_purchase.md","siteName":"Tuyo","nav":{"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"MCP tools","groups":[{"group":"Overview","pages":[{"title":"MCP tools","mode":"wide","href":"/tools"}]},{"group":"Account and pods","pages":[{"title":"Get account status","sidebarTitle":"get_account_status","href":"/tools/get_account_status"},{"title":"List pods","sidebarTitle":"list_pods","href":"/tools/list_pods"},{"title":"Create a pod","sidebarTitle":"create_pod","href":"/tools/create_pod"},{"title":"Edit a pod","sidebarTitle":"update_pod","href":"/tools/update_pod"},{"title":"Delete a pod","sidebarTitle":"delete_pod","href":"/tools/delete_pod"},{"title":"Ask for a pod card","sidebarTitle":"propose_pod_card","href":"/tools/propose_pod_card"},{"title":"Read a pod card request","sidebarTitle":"get_pod_card_proposal","href":"/tools/get_pod_card_proposal"}]},{"group":"Holdings, assets and vaults","pages":[{"title":"Get holdings","sidebarTitle":"get_holdings","href":"/tools/get_holdings"},{"title":"Get holding detail","sidebarTitle":"get_holding","href":"/tools/get_holding"},{"title":"Search supported assets","sidebarTitle":"search_assets","href":"/tools/search_assets"},{"title":"Get asset details","sidebarTitle":"get_asset","href":"/tools/get_asset"},{"title":"Search vaults","sidebarTitle":"search_vaults","href":"/tools/search_vaults"},{"title":"Get vault details","sidebarTitle":"get_vault","href":"/tools/get_vault"}]},{"group":"Transactions","pages":[{"title":"Search transactions","sidebarTitle":"search_transactions","href":"/tools/search_transactions"},{"title":"Summarize transaction activity","sidebarTitle":"summarize_transactions","href":"/tools/summarize_transactions"},{"title":"Get transaction details","sidebarTitle":"get_transaction","href":"/tools/get_transaction"},{"title":"Get account statement","sidebarTitle":"get_account_statement","href":"/tools/get_account_statement"},{"title":"List transaction categories","sidebarTitle":"list_transaction_categories","href":"/tools/list_transaction_categories"}]},{"group":"Deposits and bank accounts","pages":[{"title":"Get crypto deposit instructions","sidebarTitle":"get_crypto_deposit_instructions","href":"/tools/get_crypto_deposit_instructions"},{"title":"List bank deposit accounts","sidebarTitle":"list_bank_deposit_accounts","href":"/tools/list_bank_deposit_accounts"},{"title":"Open a bank deposit account","sidebarTitle":"create_bank_deposit_account","href":"/tools/create_bank_deposit_account"},{"title":"Close a pod's bank deposit account","sidebarTitle":"close_bank_deposit_account","href":"/tools/close_bank_deposit_account"},{"title":"List external bank accounts","sidebarTitle":"list_external_bank_accounts","href":"/tools/list_external_bank_accounts"},{"title":"Add an external bank account","sidebarTitle":"add_external_bank_account","href":"/tools/add_external_bank_account"}]},{"group":"Proposals","pages":[{"title":"Propose a send","sidebarTitle":"propose_send","href":"/tools/propose_send"},{"title":"Quote a conversion","sidebarTitle":"quote_convert","href":"/tools/quote_convert"},{"title":"Propose a conversion","sidebarTitle":"propose_convert","href":"/tools/propose_convert"},{"title":"Propose a vault deposit","sidebarTitle":"propose_vault_deposit","href":"/tools/propose_vault_deposit"},{"title":"Propose a vault withdrawal","sidebarTitle":"propose_vault_withdrawal","href":"/tools/propose_vault_withdrawal"},{"title":"Read an approval request","sidebarTitle":"get_proposal","href":"/tools/get_proposal"},{"title":"List approval requests","sidebarTitle":"list_proposals","href":"/tools/list_proposals"}]},{"group":"Purchases","pages":[{"title":"Propose a purchase","sidebarTitle":"propose_purchase","href":"/tools/propose_purchase"},{"title":"Prepare a purchase under management","description":"Start card issuance using existing pod management access, without another per-purchase owner approval; merchant checkout is still separate.","sidebarTitle":"prepare_purchase","href":"/tools/prepare_purchase"},{"title":"Read purchase readiness","sidebarTitle":"get_purchase","href":"/tools/get_purchase"},{"title":"Get encrypted purchase payment details","description":"Reveal encrypted credentials for an active purchase.","sidebarTitle":"get_purchase_payment_details","href":"/tools/get_purchase_payment_details"},{"title":"Cancel a purchase authorization","sidebarTitle":"cancel_purchase","href":"/tools/cancel_purchase"},{"title":"List this connection’s purchases","sidebarTitle":"list_purchases","href":"/tools/list_purchases"}]},{"group":"Pod management","pages":[{"title":"Get manager signer setup","sidebarTitle":"get_manager_signer","href":"/tools/get_manager_signer"},{"title":"Propose pod management","sidebarTitle":"propose_pod_management","href":"/tools/propose_pod_management"},{"title":"Read management approval","sidebarTitle":"get_pod_management_proposal","href":"/tools/get_pod_management_proposal"},{"title":"Find management proposals","sidebarTitle":"list_pod_management_proposals","href":"/tools/list_pod_management_proposals"},{"title":"List active managed pods","sidebarTitle":"list_managed_pods","href":"/tools/list_managed_pods"},{"title":"Revoke pod management","sidebarTitle":"revoke_pod_management","href":"/tools/revoke_pod_management"}]},{"group":"Managed executions","pages":[{"title":"Prepare a managed send","sidebarTitle":"prepare_send","href":"/tools/prepare_send"},{"title":"Prepare a managed conversion","sidebarTitle":"prepare_convert","href":"/tools/prepare_convert"},{"title":"Prepare a managed vault deposit","sidebarTitle":"prepare_vault_deposit","href":"/tools/prepare_vault_deposit"},{"title":"Prepare a managed vault withdrawal","sidebarTitle":"prepare_vault_withdrawal","href":"/tools/prepare_vault_withdrawal"},{"title":"Submit a signed execution","sidebarTitle":"submit_execution","href":"/tools/submit_execution"},{"title":"Read an execution","sidebarTitle":"get_execution","href":"/tools/get_execution"},{"title":"Find managed executions","sidebarTitle":"list_executions","href":"/tools/list_executions"}]},{"group":"Webhooks","pages":[{"title":"List webhook events","sidebarTitle":"list_webhook_events","href":"/tools/list_webhook_events"},{"title":"List webhooks","sidebarTitle":"list_webhooks","href":"/tools/list_webhooks"},{"title":"Create a webhook","sidebarTitle":"create_webhook","href":"/tools/create_webhook"},{"title":"Delete a webhook","sidebarTitle":"delete_webhook","href":"/tools/delete_webhook"}]},{"group":"Tuyo app and feedback","pages":[{"title":"Tuyo","sidebarTitle":"open_tuyo","href":"/tools/open_tuyo"},{"title":"Wallet","sidebarTitle":"open_tuyo_panel","href":"/tools/open_tuyo_panel"},{"title":"Load Tuyo page","sidebarTitle":"load_tuyo_page","href":"/tools/load_tuyo_page"},{"title":"Find Tuyo items","sidebarTitle":"search_tuyo_mentions","href":"/tools/search_tuyo_mentions"},{"title":"Request a feature","sidebarTitle":"feature_request","href":"/tools/feature_request"}]}]},{"tab":"Public API","pages":[{"title":"Public API","href":"/api-reference/get-the-active-public-api-contract-version"}]}]},"basePath":"","title":"Read purchase readiness - Tuyo","buildId":"47ec198d4b6d","dynamics":[],"chunks":[]}