Polls the current status of a transaction that was previously registered with Track Transaction (POST /v2/tx/track). Returns the overall status and the state of each hop in the transfer sequence.
Call this endpoint repeatedly until the status reaches a terminal state (e.g. STATE_COMPLETED or STATE_FAILED). This is useful for showing transfer progress in your UI.
GET
/
v2
/
tx
/
status
Get Transaction Status
curl --request GET \ --url https://router-api.initia.xyz/v2/tx/status
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Initia Docs","colors":{"primary":"#324242","light":"#7ad9f7","dark":"#4349FF"},"logo":{"light":"https://mintcdn.com/initialabs/Uwhc6AAplUb4pVeK/logo/logo_light.svg?fit=max\u0026auto=format\u0026n=Uwhc6AAplUb4pVeK\u0026q=85\u0026s=ac94fed481d8ea8bc33f6ed287d41767","dark":"https://mintcdn.com/initialabs/Uwhc6AAplUb4pVeK/logo/logo_dark.svg?fit=max\u0026auto=format\u0026n=Uwhc6AAplUb4pVeK\u0026q=85\u0026s=7c64051e297de71f104d0622d2050fb1"},"favicon":"https://mintcdn.com/initialabs/Uwhc6AAplUb4pVeK/favicon.svg?fit=max\u0026auto=format\u0026n=Uwhc6AAplUb4pVeK\u0026q=85\u0026s=632e02bc14dd8d68d7a088ccb36d92fc","api":{"openapi":["api-reference/router-api/openapi.yaml","api-reference/rollup-indexer/openapi.yaml"],"playground":{"display":"interactive","proxy":true},"mdx":{"server":"https://rest.testnet.initia.xyz"}},"appearance":{"default":"dark"},"background":{"decoration":"grid","color":{"dark":"#060606"}},"footer":{"socials":{"twitter":"https://x.com/initia","discord":"https://discord.gg/initia","github":"https://github.com/initia-labs"}},"integrations":{"ga4":{"measurementId":"G-MEX41J56YX"}},"contextual":{"options":["copy","view","chatgpt","claude","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Twitter","icon":"twitter","href":"https://x.com/initia"},{"anchor":"Discord","icon":"discord","href":"https://discord.gg/initia"},{"anchor":"GitHub","icon":"github","href":"https://github.com/initia-labs"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"initialabs","hasAudioNarration":false,"actualSubdomain":"initialabs","customDomains":["docs.initia.xyz"],"gitSource":{"type":"github","owner":"initia-labs","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6a67696b99c83776a49bc5dd","collectionId":"a0dca5b1-7b51-4b8f-a147-4b0659afb2a7","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6a67696b99c83776a49bc5dd"},"feedback":{"thumbs":true,"edits":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6a67696b99c83776a49bc5dd:success","clientVersion":"0.0.4045","searchFilterCounts":[{"language":"default","tag":"Developers","count":58},{"language":"default","tag":"API Reference","count":56},{"language":"default","tag":"InterwovenKit","count":34},{"language":"default","tag":"Home","count":28},{"language":"default","tag":"Tools","count":25},{"language":"default","tag":"Core Concepts","count":25},{"language":"default","tag":"Indexer API","count":24},{"language":"default","tag":"VM Specific Tutorials","count":15},{"language":"default","tag":"CLIs","count":14},{"language":"default","tag":"EVM","count":14}]},"assistantConfig":{"enableAskAiButton":true,"enableAskAiSearchBar":false},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/tracking-transactions/get-transaction-status","slug":"/api-reference/tracking-transactions/get-transaction-status","pageMetadata":{"title":"Get Transaction Status","description":"Polls the current status of a transaction that was previously registered with Track Transaction (`POST /v2/tx/track`). Returns the overall status and the state of each hop in the transfer sequence.\n\nCall this endpoint repeatedly until the status reaches a terminal state (e.g. `STATE_COMPLETED` or `STATE_FAILED`). This is useful for showing transfer progress in your UI.","deprecated":null,"version":null,"openapi":"/api-reference/router-api/openapi.yaml get /v2/tx/status","href":"/api-reference/tracking-transactions/get-transaction-status","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, 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(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Polls the current status of a transaction that was previously registered with Track Transaction (\", _jsx(_components.code, {\n children: \"POST /v2/tx/track\"\n }), \"). Returns the overall status and the state of each hop in the transfer sequence.\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Call this endpoint repeatedly until the status reaches a terminal state (e.g. \", _jsx(_components.code, {\n children: \"STATE_COMPLETED\"\n }), \" or \", _jsx(_components.code, {\n children: \"STATE_FAILED\"\n }), \"). This is useful for showing transfer progress in your UI.\"]\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":{"config":{},"pageMetadata":{"title":"Get Transaction Status","description":"Polls the current status of a transaction that was previously registered with Track Transaction (`POST /v2/tx/track`). Returns the overall status and the state of each hop in the transfer sequence.\n\nCall this endpoint repeatedly until the status reaches a terminal state (e.g. `STATE_COMPLETED` or `STATE_FAILED`). This is useful for showing transfer progress in your UI.","deprecated":null,"version":null,"openapi":"/api-reference/router-api/openapi.yaml get /v2/tx/status","href":"/api-reference/tracking-transactions/get-transaction-status","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"getTransactionStatus","summary":"Get Transaction Status","description":"Polls the current status of a transaction that was previously registered with Track Transaction (`POST /v2/tx/track`). Returns the overall status and the state of each hop in the transfer sequence.\n\nCall this endpoint repeatedly until the status reaches a terminal state (e.g. `STATE_COMPLETED` or `STATE_FAILED`). This is useful for showing transfer progress in your UI.","tags":["Tracking Transactions"],"parameters":["8f3f96ee-a789-4dbd-9f90-4422dbd78929","0a41195f-0658-430f-b7af-a3d0a82f51c0"],"responses":{"200":"62019706-517b-4812-bb19-d62a6b1a6728"},"method":"get","type":"path","servers":["9dfeb694-461d-4028-9e98-aaaaac0c780b","e38be52a-8309-4cb1-8e99-b8079cc517da"],"security":[],"path":"/v2/tx/status","baseUrlOptions":["https://router-api.initia.xyz","https://router-api.initiation-2.initia.xyz"],"title":"Get Transaction Status","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"8f3f96ee-a789-4dbd-9f90-4422dbd78929":{"name":"tx_hash","in":"query","required":true,"description":"The transaction hash to check.","schema":{"type":"string","isRequired":true,"description":"The transaction hash to check.","uniqueKey":"","typeLabel":"string"}},"0a41195f-0658-430f-b7af-a3d0a82f51c0":{"name":"chain_id","in":"query","required":true,"description":"The chain ID where the transaction was submitted.","schema":{"type":"string","isRequired":true,"description":"The chain ID where the transaction was submitted.","uniqueKey":"","typeLabel":"string"}}},"responses":{"62019706-517b-4812-bb19-d62a6b1a6728":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object","properties":{"state":{"type":"string","description":"Overall end-to-end transaction state (e.g. STATE_SUBMITTED, STATE_PENDING, STATE_COMPLETED_SUCCESS, STATE_COMPLETED_ERROR, STATE_ABANDONED, STATE_PENDING_ERROR).","uniqueKey":"state","typeLabel":"string"},"transfers":{"type":"array","description":"Transfer status for all transfers in the route.","items":{"type":"object","uniqueKey":"transfers.items.[INDEX]","typeLabel":"object"},"uniqueKey":"transfers","typeLabel":"object[]"},"transfer_sequence":{"type":"array","description":"Deprecated. Flat list of transfer events in sequence order.","items":{"type":"object","properties":{"src_chain_id":{"type":"string","uniqueKey":"transfer_sequence.items.[INDEX].src_chain_id","typeLabel":"string"},"dst_chain_id":{"type":"string","uniqueKey":"transfer_sequence.items.[INDEX].dst_chain_id","typeLabel":"string"},"state":{"type":"string","uniqueKey":"transfer_sequence.items.[INDEX].state","typeLabel":"string"}},"uniqueKey":"transfer_sequence.items.[INDEX]","typeLabel":"object"},"uniqueKey":"transfer_sequence","typeLabel":"object[]"},"next_blocking_transfer":{"oneOf":[{"type":"object","description":"The next transfer that is blocking progress, if any.","properties":{"transfer_sequence_index":{"type":"integer","uniqueKey":"next_blocking_transfer.oneOf.0.transfer_sequence_index","typeLabel":"integer"}},"uniqueKey":"next_blocking_transfer.oneOf.0","typeLabel":"object"},{"type":"null","description":"The next transfer that is blocking progress, if any.","properties":{"transfer_sequence_index":{"type":"integer"}},"uniqueKey":"next_blocking_transfer.oneOf.1","typeLabel":"null"}],"uniqueKey":"next_blocking_transfer","typeLabel":"object | null"},"transfer_asset_release":{"oneOf":[{"type":"object","description":"Information about released assets.","properties":{"chain_id":{"type":"string","uniqueKey":"transfer_asset_release.oneOf.0.chain_id","typeLabel":"string"},"denom":{"type":"string","uniqueKey":"transfer_asset_release.oneOf.0.denom","typeLabel":"string"},"amount":{"oneOf":[{"type":"string","uniqueKey":"transfer_asset_release.oneOf.0.amount.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"transfer_asset_release.oneOf.0.amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"transfer_asset_release.oneOf.0.amount","typeLabel":"string | null"},"released":{"type":"boolean","uniqueKey":"transfer_asset_release.oneOf.0.released","typeLabel":"boolean"}},"uniqueKey":"transfer_asset_release.oneOf.0","typeLabel":"object"},{"type":"null","description":"Information about released assets.","properties":{"chain_id":{"type":"string"},"denom":{"type":"string"},"amount":{"oneOf":[{"type":"string"},{"type":"null"}]},"released":{"type":"boolean"}},"uniqueKey":"transfer_asset_release.oneOf.1","typeLabel":"null"}],"uniqueKey":"transfer_asset_release","typeLabel":"object | null"},"error":{"oneOf":[{"type":"object","description":"Error details if the transaction failed.","uniqueKey":"error.oneOf.0","typeLabel":"object"},{"type":"null","description":"Error details if the transaction failed.","uniqueKey":"error.oneOf.1","typeLabel":"null"}],"uniqueKey":"error","typeLabel":"object | null"}},"uniqueKey":"","typeLabel":"object"},"example":{"state":"STATE_COMPLETED_SUCCESS","transfers":[],"transfer_sequence":[{"src_chain_id":"interwoven-1","dst_chain_id":"8453","state":"TRANSFER_SUCCESS"}],"next_blocking_transfer":null,"transfer_asset_release":null,"error":null},"examples":{"Example":{"title":"Example","value":{"state":"STATE_COMPLETED_SUCCESS","transfers":[],"transfer_sequence":[{"src_chain_id":"interwoven-1","dst_chain_id":"8453","state":"TRANSFER_SUCCESS"}],"next_blocking_transfer":null,"transfer_asset_release":null,"error":null}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{},"servers":{"9dfeb694-461d-4028-9e98-aaaaac0c780b":{"url":"https://router-api.initia.xyz","description":"Mainnet"},"e38be52a-8309-4cb1-8e99-b8079cc517da":{"url":"https://router-api.initiation-2.initia.xyz","description":"Testnet"}}},"originalFileLocation":"api-reference/router-api/openapi.yaml"},"subdomain":"initialabs","siteName":"Initia Docs","title":"Get Transaction Status - Initia Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-05-27T07:10:49.496Z","originalFileLocation":"api-reference/tracking-transactions/get-transaction-status.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=\"dark\"}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=\"Polls the current status of a transaction that was previously registered with Track Transaction (POST /v2/tx/track). Returns the overall status and the state of each hop in the transfer sequence. Call this endpoint repeatedly until the status reaches a terminal state (e.g. STATE_COMPLETED or STATE_FAILED). This is useful for showing transfer progress in your UI.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Initia Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/initialabs/_d_tyT_z0U8a7tAx/_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/initialabs/_d_tyT_z0U8a7tAx/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/initialabs/_d_tyT_z0U8a7tAx/_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/initialabs/_d_tyT_z0U8a7tAx/_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/initialabs/_d_tyT_z0U8a7tAx/_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/initialabs/_d_tyT_z0U8a7tAx/_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/initialabs/_d_tyT_z0U8a7tAx/_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/initialabs/_d_tyT_z0U8a7tAx/_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/initialabs/_d_tyT_z0U8a7tAx/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Transaction Status - Initia Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Polls the current status of a transaction that was previously registered with Track Transaction (POST /v2/tx/track). Returns the overall status and the state of each hop in the transfer sequence. Call this endpoint repeatedly until the status reaches a terminal state (e.g. STATE_COMPLETED or STATE_FAILED). This is useful for showing transfer progress in your UI.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Initia Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.initia.xyz/api-reference/tracking-transactions/get-transaction-status\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://initialabs.mintlify.app/_mintlify/api/og/v2?division=Tracking+Transactions\u0026amp;title=Get+Transaction+Status\u0026amp;description=Polls+the+current+status+of+a+transaction+that+was+previously+registered+with+Track+Transaction+%28%60POST+%2Fv2%2Ftx%2Ftrack%60%29.+Returns+the+overall+status+and+the+state+\u0026amp;theme=e29f2c35b4742e650dd7e8e8\u0026amp;signature=f717bc27c8b732c2b7d0a86c6dc4128f6bd7aa7204dd8fa4862fa99b692a93a3\">\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 Transaction Status - Initia Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Polls the current status of a transaction that was previously registered with Track Transaction (POST /v2/tx/track). Returns the overall status and the state of each hop in the transfer sequence. Call this endpoint repeatedly until the status reaches a terminal state (e.g. STATE_COMPLETED or STATE_FAILED). This is useful for showing transfer progress in your UI.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://initialabs.mintlify.app/_mintlify/api/og/v2?division=Tracking+Transactions\u0026amp;title=Get+Transaction+Status\u0026amp;description=Polls+the+current+status+of+a+transaction+that+was+previously+registered+with+Track+Transaction+%28%60POST+%2Fv2%2Ftx%2Ftrack%60%29.+Returns+the+overall+status+and+the+state+\u0026amp;theme=e29f2c35b4742e650dd7e8e8\u0026amp;signature=f717bc27c8b732c2b7d0a86c6dc4128f6bd7aa7204dd8fa4862fa99b692a93a3\">\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/initialabs/_d_tyT_z0U8a7tAx/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Initia Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#324242\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.initia.xyz/api-reference/tracking-transactions/get-transaction-status\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/tracking-transactions/get-transaction-status.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.initia.xyz/#organization\",\"name\":\"Initia Docs\",\"url\":\"https://docs.initia.xyz\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/initialabs/Uwhc6AAplUb4pVeK/logo/logo_light.svg?fit=max\u0026auto=format\u0026n=Uwhc6AAplUb4pVeK\u0026q=85\u0026s=ac94fed481d8ea8bc33f6ed287d41767\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.initia.xyz#website\",\"name\":\"Initia Docs\",\"url\":\"https://docs.initia.xyz\",\"publisher\":{\"@id\":\"https://docs.initia.xyz/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.initia.xyz/api-reference/tracking-transactions/get-transaction-status#webpage\",\"url\":\"https://docs.initia.xyz/api-reference/tracking-transactions/get-transaction-status\",\"name\":\"Get Transaction Status\",\"description\":\"Polls the current status of a transaction that was previously registered with Track Transaction (POST /v2/tx/track). Returns the overall status and the state of each hop in the transfer sequence. Call this endpoint repeatedly until the status reaches a terminal state (e.g. STATE_COMPLETED or STATE_FAILED). This is useful for showing transfer progress in your UI.\",\"dateModified\":\"2026-05-27T07:10:49.496Z\",\"isPartOf\":{\"@id\":\"https://docs.initia.xyz#website\"},\"breadcrumb\":{\"@id\":\"https://docs.initia.xyz/api-reference/tracking-transactions/get-transaction-status#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.initia.xyz/api-reference/tracking-transactions/get-transaction-status#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Router API\",\"item\":\"https://docs.initia.xyz/api-reference/router-api/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Tracking Transactions\",\"item\":\"https://docs.initia.xyz/api-reference/tracking-transactions/track-transaction\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get Transaction Status\",\"item\":\"https://docs.initia.xyz/api-reference/tracking-transactions/get-transaction-status\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.initia.xyz/api-reference/tracking-transactions/get-transaction-status#apireference\",\"headline\":\"Get Transaction Status\",\"name\":\"Get Transaction Status\",\"description\":\"Polls the current status of a transaction that was previously registered with Track Transaction (POST /v2/tx/track). Returns the overall status and the state of each hop in the transfer sequence. Call this endpoint repeatedly until the status reaches a terminal state (e.g. STATE_COMPLETED or STATE_FAILED). This is useful for showing transfer progress in your UI.\",\"url\":\"https://docs.initia.xyz/api-reference/tracking-transactions/get-transaction-status\",\"mainEntityOfPage\":{\"@id\":\"https://docs.initia.xyz/api-reference/tracking-transactions/get-transaction-status#webpage\"},\"dateModified\":\"2026-05-27T07:10:49.496Z\",\"publisher\":{\"@id\":\"https://docs.initia.xyz/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.initia.xyz#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Initia Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Initia Docs","nav":{"global":{"anchors":[{"anchor":"Twitter","icon":"twitter","href":"https://x.com/initia"},{"anchor":"Discord","icon":"discord","href":"https://discord.gg/initia"},{"anchor":"GitHub","icon":"github","href":"https://github.com/initia-labs"}]},"tabs":[{"tab":"Home","pages":[{"title":"Home","href":"/home/general/welcome"}]},{"tab":"User Guides","pages":[{"title":"User Guides","href":"/user-guides/wallet/auto-signing/introduction"}]},{"tab":"Nodes and Rollups","pages":[{"title":"Nodes and Rollups","href":"/nodes-and-rollups/introduction"}]},{"tab":"Developers","pages":[{"title":"Developers","href":"/developers/introduction"}]},{"tab":"InterwovenKit","pages":[{"title":"InterwovenKit","href":"/interwovenkit/introduction"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"title":"Overview","href":"/api-reference/introduction"}]},{"group":"Router API","pages":[{"title":"Introduction","href":"/api-reference/router-api/introduction"},{"title":"Usage","href":"/api-reference/router-api/usage"},{"group":"Assets \u0026 Chains","pages":[{"title":"Get Assets","deprecated":null,"version":null,"openapi":"/api-reference/router-api/openapi.yaml get /v2/fungible/assets","href":"/api-reference/assets-\u0026-chains/get-assets"},{"title":"Get Chains","deprecated":null,"version":null,"openapi":"/api-reference/router-api/openapi.yaml get /v2/info/chains","href":"/api-reference/assets-\u0026-chains/get-chains"},{"title":"Get Balances","deprecated":null,"version":null,"openapi":"/api-reference/router-api/openapi.yaml post /v2/info/balances","href":"/api-reference/assets-\u0026-chains/get-balances"}]},{"group":"Routing","pages":[{"title":"Compute Route","deprecated":null,"version":null,"openapi":"/api-reference/router-api/openapi.yaml post /v2/fungible/route","href":"/api-reference/routing/compute-route"},{"title":"Generate Transaction","deprecated":null,"version":null,"openapi":"/api-reference/router-api/openapi.yaml post /v2/fungible/msgs","href":"/api-reference/routing/generate-transaction"},{"title":"Get OP hook","deprecated":null,"version":null,"openapi":"/api-reference/router-api/openapi.yaml post /op-hook","href":"/api-reference/routing/get-op-hook"}]},{"group":"Tracking Transactions","pages":[{"title":"Track Transaction","description":"Registers a transaction for cross-chain tracking. Call this once with the transaction hash and chain ID immediately after broadcasting. This is required before you can poll the transaction status.\n\nAfter calling this endpoint, use Get Transaction Status (`GET /v2/tx/status`) to poll for progress updates.","deprecated":null,"version":null,"openapi":"/api-reference/router-api/openapi.yaml post /v2/tx/track","href":"/api-reference/tracking-transactions/track-transaction"},{"title":"Get Transaction Status","deprecated":null,"version":null,"openapi":"/api-reference/router-api/openapi.yaml get /v2/tx/status","href":"/api-reference/tracking-transactions/get-transaction-status"}]},{"group":"NFT","pages":[{"title":"NFT Transfer","description":"Computes routes and generates transaction messages for cross-chain NFT transfers within the Initia ecosystem. Supports:\n- Same-chain transfers (EVM, Move, and Wasm chains)\n- Single-hop IBC (L2 to L1 or L1 to L2 via ICS-721)\n- Multi-hop (L2 to L1 to L2, two IBC hops)","deprecated":null,"version":null,"openapi":"/api-reference/router-api/openapi.yaml post /nft","href":"/api-reference/nft/nft-transfer"}]},{"group":"RPC","pages":[{"title":"Cosmos RPC Proxy","deprecated":null,"version":null,"openapi":"/api-reference/router-api/openapi.yaml post /api/rpc/{chainId}","href":"/api-reference/rpc/cosmos-rpc-proxy"}]}]},{"group":"Indexer API","pages":[{"title":"Introduction","href":"/api-reference/rollup-indexer/introduction"},{"group":"Blocks","pages":[{"title":"Get blocks","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/block/v1/blocks","href":"/api-reference/blocks/get-blocks"},{"title":"Get block by height","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/block/v1/blocks/{height}","href":"/api-reference/blocks/get-block-by-height"},{"title":"Get average block time","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/block/v1/avg_blocktime","href":"/api-reference/blocks/get-average-block-time"}]},{"group":"Transactions","pages":[{"title":"Get transactions","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/tx/v1/txs","href":"/api-reference/transactions/get-transactions"},{"title":"Get transactions by account","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/tx/v1/txs/by_account/{account}","href":"/api-reference/transactions/get-transactions-by-account"},{"title":"Get transactions by height","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/tx/v1/txs/by_height/{height}","href":"/api-reference/transactions/get-transactions-by-height"},{"title":"Get transaction by hash","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/tx/v1/txs/{tx_hash}","href":"/api-reference/transactions/get-transaction-by-hash"}]},{"group":"EVM Transactions","pages":[{"title":"Get EVM transactions","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/tx/v1/evm-txs","href":"/api-reference/evm-transactions/get-evm-transactions"},{"title":"Get EVM transactions by account","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/tx/v1/evm-txs/by_account/{account}","href":"/api-reference/evm-transactions/get-evm-transactions-by-account"},{"title":"Get EVM transactions by height","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/tx/v1/evm-txs/by_height/{height}","href":"/api-reference/evm-transactions/get-evm-transactions-by-height"},{"title":"Get EVM transaction by hash","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/tx/v1/evm-txs/{tx_hash}","href":"/api-reference/evm-transactions/get-evm-transaction-by-hash"}]},{"group":"EVM Internal Transactions","pages":[{"title":"Get EVM internal transactions","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/tx/v1/evm-internal-txs","href":"/api-reference/evm-internal-transactions/get-evm-internal-transactions"},{"title":"Get EVM internal transactions by account","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/tx/v1/evm-internal-txs/by_account/{account}","href":"/api-reference/evm-internal-transactions/get-evm-internal-transactions-by-account"},{"title":"Get EVM internal transactions by height","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/tx/v1/evm-internal-txs/by_height/{height}","href":"/api-reference/evm-internal-transactions/get-evm-internal-transactions-by-height"},{"title":"Get EVM internal transactions by hash","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/tx/v1/evm-internal-txs/{tx_hash}","href":"/api-reference/evm-internal-transactions/get-evm-internal-transactions-by-hash"}]},{"group":"NFTs","pages":[{"title":"Get NFT collections","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/nft/v1/collections","href":"/api-reference/nfts/get-nft-collections"},{"title":"Get NFT collections by account","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/nft/v1/collections/by_account/{account}","href":"/api-reference/nfts/get-nft-collections-by-account"},{"title":"Get NFT collections by name","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/nft/v1/collections/by_name/{name}","href":"/api-reference/nfts/get-nft-collections-by-name"},{"title":"Get NFT collection details","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/nft/v1/collections/{collection_addr}","href":"/api-reference/nfts/get-nft-collection-details"},{"title":"Get NFT tokens by account","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/nft/v1/tokens/by_account/{account}","href":"/api-reference/nfts/get-nft-tokens-by-account"},{"title":"Get NFT tokens by collection","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/nft/v1/tokens/by_collection/{collection_addr}","href":"/api-reference/nfts/get-nft-tokens-by-collection"},{"title":"Get NFT transactions","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/nft/v1/txs/{collection_addr}/{token_id}","href":"/api-reference/nfts/get-nft-transactions"}]},{"group":"Rich List","pages":[{"title":"Get token holders","deprecated":null,"version":null,"openapi":"/api-reference/rollup-indexer/openapi.yaml get /indexer/richlist/v1/{denom}","href":"/api-reference/rich-list/get-token-holders"}]}]}]},{"tab":"AI","pages":[{"title":"AI","href":"/ai/overview"}]},{"tab":"Resources","pages":[{"title":"Resources","href":"/resources/developer/initia-l1"}]}]},"basePath":"","title":"Get Transaction Status - Initia Docs","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}