Read payment methods on the standard API host (https://staging.crossmint.com in staging, https://www.crossmint.com in production), not the vault host. On the vault host, reads fail with Invalid payment method type.
Returns the banks of one country that a bank-account payment method accepts, sorted by name. Send the institutionId of the bank your user picks as bankAccount.institutionId when you create the payment method.You can call this endpoint from a frontend with a client-side API key that has the payment-methods.read scope.
An object with the uppercase country and an institutions array of { institutionId, name } objects. The array is empty for US, MX, AE, BR and the SEPA countries, because the account details or the IBAN identify the bank. Ignore response fields that you do not know: new fields can appear.The response has Cache-Control: no-cache and an ETag. Send the ETag back in If-None-Match to get 304 when the list did not change.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Crossmint Docs","colors":{"primary":"#36b37e","light":"#87ff8f","dark":"#001d01"},"logo":{"light":"https://mintcdn.com/crossmint/a8gPOTKEuVFcSfC3/logo/crossmint-light.png?fit=max\u0026auto=format\u0026n=a8gPOTKEuVFcSfC3\u0026q=85\u0026s=8c2671e4c8f7da6956e1508bd68c2928","dark":"https://mintcdn.com/crossmint/a8gPOTKEuVFcSfC3/logo/crossmint-dark.png?fit=max\u0026auto=format\u0026n=a8gPOTKEuVFcSfC3\u0026q=85\u0026s=272ecc17664d17b9ff24471758ff80b2"},"favicon":"https://mintcdn.com/crossmint/xq66q9GV6z6jjj95/favicon.png?fit=max\u0026auto=format\u0026n=xq66q9GV6z6jjj95\u0026q=85\u0026s=00fb89ddf6ba5b1022b9307039c08006","api":{"openapi":["api-reference/_open-api/MintingAPIs.json","api-reference/_open-api/AdminAPIs.json","api-reference/_open-api/VerifiableCredentialsAPIs.json","api-reference/_open-api/Wallets.json"],"examples":{"prefill":true}},"background":{"color":{"dark":"#090b0c"}},"navbar":{"links":[{"href":"https://www.crossmint.com/contact","label":"Support"},{"href":"https://staging.crossmint.com/console","label":"Staging Console"}],"primary":{"type":"button","label":"Console","href":"https://www.crossmint.com/console"}},"footer":{"socials":{"website":"https://www.crossmint.com","twitter":"https://twitter.com/crossmint","github":"https://github.com/crossmint"}},"integrations":{"ga4":{"measurementId":"G-CP5EDD6GVT"},"posthog":{"apiKey":"phc_tfgodwfjuO9v3Nw0tIWJNzACoi2opL7X2Ly0Mg2UCTz","apiHost":"https://eu.i.posthog.com","sessionRecording":false}},"contextual":{"options":["copy","view","chatgpt","claude"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"crossmint","hasAudioNarration":false,"actualSubdomain":"crossmint","customDomains":["docs.crossmint.com"],"gitSource":{"type":"github","owner":"paella-labs","repo":"crossbit-main","deployBranch":"main","contentDirectory":"apps/crossmint-mintlify-docs/src","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"edits":true,"issues":true,"contextualFeedback":{"allowEmail":true},"agentFeedback":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"ENABLED"},"CONTEXTUAL_FEEDBACK":{"status":"ENABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6af39f2e54bde4af780e17dc","clientVersion":"0.0.4102","searchFilterCounts":[{"language":"default","tag":"API Reference","count":1094},{"language":"default","tag":"Wallets","count":870},{"language":"default","tag":"Kotlin SDK","count":427},{"language":"default","tag":"Swift SDK","count":237},{"language":"default","tag":"Checkout","count":196},{"language":"default","tag":"Classes","count":182},{"language":"default","tag":"Data Classes","count":182},{"language":"default","tag":"Typescript SDK","count":156},{"language":"default","tag":"Guides","count":134},{"language":"default","tag":"Structs","count":127}]},"assistantConfig":{"enableAskAiButton":true,"enableStarterQuestions":false,"enableAskAiSearchBar":false,"deflection":{"enabled":true,"type":"link","url":"https://www.crossmint.com/contact/sales"}},"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":".tab-container [data-component-part=\"tabs-list\"]{flex-wrap:wrap;overflow:visible;row-gap:0.25rem}.tab-container [data-component-part=\"tabs-list\"]>li{white-space:nowrap}.nav-dropdown-item,.nav-dropdown-item *{font-weight:500!important;color:rgb(75, 85, 99)!important}.nav-dropdown-item:hover,.nav-dropdown-item:hover *{color:rgb(31, 41, 55)!important}.dark .nav-dropdown-item,.dark .nav-dropdown-item *{color:rgb(156, 163, 175)!important}.dark .nav-dropdown-item:hover,.dark .nav-dropdown-item:hover *{color:rgb(209, 213, 219)!important}"}],"page":{"pagePath":"offramp/api-reference/payment-methods/list-institutions","slug":"/offramp/api-reference/payment-methods/list-institutions","pageMetadata":{"title":"List Bank Institutions","description":"Retrieve the banks of a country and their institutionId values","openapi":"api-reference/_open-api/PaymentMethods.json GET /2026-09-16/payment-methods/institutions","href":"/offramp/api-reference/payment-methods/list-institutions"},"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: \"Retrieve the banks of a country and their institutionId values\"\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`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Info}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[`Read payment methods on the standard API host (`,_jsx(_components.code,{children:`https://staging.crossmint.com`}),` in staging, `,_jsx(_components.code,{children:`https://www.crossmint.com`}),` in production), not the vault host. On the vault host, reads fail with `,_jsx(_components.code,{children:`Invalid payment method type.`})]})}),`\n`,_jsxs(_components.p,{children:[`Returns the banks of one country that a bank-account payment method accepts, sorted by name. Send the `,_jsx(_components.code,{children:`institutionId`}),` of the bank your user picks as `,_jsx(_components.code,{children:`bankAccount.institutionId`}),` when you `,_jsx(_components.a,{href:`/offramp/api-reference/payment-methods/create-payment-method`,children:`create the payment method`}),`.`]}),`\n`,_jsxs(_components.p,{children:[`You can call this endpoint from a frontend with a client-side API key that has the `,_jsx(_components.code,{children:`payment-methods.read`}),` scope.`]}),`\n`,_jsx(Heading,{level:`2`,id:`returns`,children:`Returns`}),`\n`,_jsxs(_components.p,{children:[`An object with the uppercase `,_jsx(_components.code,{children:`country`}),` and an `,_jsx(_components.code,{children:`institutions`}),` array of `,_jsx(_components.code,{children:`{ institutionId, name }`}),` objects. The array is empty for `,_jsx(_components.code,{children:`US`}),`, `,_jsx(_components.code,{children:`MX`}),`, `,_jsx(_components.code,{children:`AE`}),`, `,_jsx(_components.code,{children:`BR`}),` and the SEPA countries, because the account details or the IBAN identify the bank. Ignore response fields that you do not know: new fields can appear.`]}),`\n`,_jsxs(_components.p,{children:[`The response has `,_jsx(_components.code,{children:`Cache-Control: no-cache`}),` and an `,_jsx(_components.code,{children:`ETag`}),`. Send the `,_jsx(_components.code,{children:`ETag`}),` back in `,_jsx(_components.code,{children:`If-None-Match`}),` to get `,_jsx(_components.code,{children:`304`}),` when the list did not change.`]}),`\n`,_jsx(Heading,{level:`2`,id:`see-also`,children:`See Also`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/offramp/guides/institution-ids`,children:`Institution IDs`})}),`\n`,_jsx(_components.li,{children:_jsx(_components.a,{href:`/offramp/api-reference/payment-methods/create-payment-method`,children:`Create Payment Method`})}),`\n`]})]})}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":"List Bank Institutions","description":"Retrieve the banks of a country and their institutionId values","openapi":"api-reference/_open-api/PaymentMethods.json GET /2026-09-16/payment-methods/institutions","href":"/offramp/api-reference/payment-methods/list-institutions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Returns","slug":"returns","depth":2,"children":[]},{"title":"See Also","slug":"see-also","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/crossmint/d1c432d03c0c4224/scripts/dd.js","/_mintlify/custom/crossmint/7fc8d54052d3edb0/scripts/hubspot.js"],"openApiReferenceData":{"operation":{"description":"Retrieve the banks of a country and their institutionId values","operationId":"paymentMethods.v20260916.institutions.list","parameters":["7047445e-7fc0-4786-b6cf-76725435724e"],"responses":{"200":"63554f07-7038-4645-92f1-f9a5e582b69c","400":"f72a2067-5149-48dc-98f9-6e193a6e1624","401":"b9008454-a8d5-4f57-9f4b-65f61b9b3685","403":"712ef2cd-c8eb-4cde-8ef8-5c17991958ac","429":"91c5d302-f487-4df0-aeda-c35e12db47da"},"security":["8596ba3f-376f-4bc4-9e2e-5bfb5b0c6380"],"summary":"List Bank Institutions","tags":["Payment Methods"],"method":"get","type":"path","servers":["87fa3d6d-437d-48c5-8c30-749521673eea","b2297053-6bcc-400a-bce0-bdc75db09bfb"],"path":"/2026-09-16/payment-methods/institutions","baseUrlOptions":["https://staging.crossmint.com/api","https://www.crossmint.com/api"],"title":"List Bank Institutions","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"7047445e-7fc0-4786-b6cf-76725435724e":{"description":"ISO 3166-1 alpha-2 country code, in any case.","in":"query","name":"country","required":true,"schema":{"type":"string","isRequired":true,"description":"ISO 3166-1 alpha-2 country code, in any case.","uniqueKey":"","typeLabel":"string"}}},"responses":{"63554f07-7038-4645-92f1-f9a5e582b69c":{"content":{"application/json":{"example":{"country":"PH","institutions":[{"institutionId":"ph-banco-de-oro","name":"Banco De Oro"},{"institutionId":"ph-maya-bank","name":"Maya Bank, Inc."}]},"schema":{"properties":{"country":{"description":"The requested country, in uppercase.","enum":["AD","AE","AF","AG","AI","AL","AM","AO","AQ","AR","AS","AT","AU","AW","AX","AZ","BA","BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS","BT","BV","BW","BY","BZ","CA","CC","CD","CF","CG","CH","CI","CK","CL","CM","CN","CO","CR","CU","CV","CW","CX","CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","EH","ER","ES","ET","FI","FJ","FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GL","GM","GN","GP","GQ","GR","GS","GT","GU","GW","GY","HK","HM","HN","HR","HT","HU","ID","IE","IL","IM","IN","IO","IQ","IR","IS","IT","JE","JM","JO","JP","KE","KG","KH","KI","KM","KN","KP","KR","KW","KY","KZ","LA","LB","LC","LI","LK","LR","LS","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK","ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ","NA","NC","NE","NF","NG","NI","NL","NO","NP","NR","NU","NZ","OM","PA","PE","PF","PG","PH","PK","PL","PM","PN","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SB","SC","SD","SE","SG","SH","SI","SJ","SK","SL","SM","SN","SO","SR","SS","ST","SV","SX","SY","SZ","TC","TD","TF","TG","TH","TJ","TK","TL","TM","TN","TO","TR","TT","TV","TW","TZ","UA","UG","UM","US","UY","UZ","VA","VC","VE","VG","VI","VN","VU","WF","WS","XK","YE","YT","ZA","ZM","ZW"],"type":"string","isRequired":true,"uniqueKey":"country","typeLabel":"enum\u003cstring>"},"institutions":{"description":"The banks of the country, sorted by name.","items":{"properties":{"institutionId":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"institutions.items.[INDEX].institutionId","typeLabel":"string"},"name":{"minLength":1,"type":"string","isRequired":true,"uniqueKey":"institutions.items.[INDEX].name","typeLabel":"string"}},"required":["institutionId","name"],"type":"object","uniqueKey":"institutions.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"institutions","typeLabel":"object[]"}},"required":["country","institutions"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"country":"PH","institutions":[{"institutionId":"ph-banco-de-oro","name":"Banco De Oro"},{"institutionId":"ph-maya-bank","name":"Maya Bank, Inc."}]}}},"exampleType":"examples"}},"description":"The banks of the country. Revalidate with the `ETag`: a match gives 304.","exampleType":"examples"},"f72a2067-5149-48dc-98f9-6e193a6e1624":{"content":{"application/json":{"examples":{"country_not_supported":{"title":"country_not_supported","value":{"code":"payments:institutions.country-not-supported","error":true,"message":"No bank-account payment method is available for JP."}},"invalid_country":{"title":"invalid_country","value":{"error":true,"message":"country: must be an ISO 3166-1 alpha-2 country code, for example `PH`"}}},"schema":{"properties":{"error":{"example":true,"type":"boolean","isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"description":"Human-readable error message describing what went wrong","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"Machine-readable error code for programmatic handling","type":"string","uniqueKey":"code","typeLabel":"string"},"parameters":{"additionalProperties":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"parameters.additionalProperties.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"parameters.additionalProperties.oneOf.0","typeLabel":"string[]"},{"type":"string","uniqueKey":"parameters.additionalProperties.oneOf.1","typeLabel":"string"}],"uniqueKey":"parameters.additionalProperties","typeLabel":"string[] | string"},"description":"Values that explain a coded error, such as the limit that was exceeded, the amount that remains, or the list of supported currencies.","type":"object","uniqueKey":"parameters","typeLabel":"object"}},"required":["error","message"],"type":"object","uniqueKey":"","typeLabel":"object"},"exampleType":"examples"}},"description":"`country` is not a country code, or no bank-account payment method serves the country.","exampleType":"examples"},"b9008454-a8d5-4f57-9f4b-65f61b9b3685":{"content":{"application/json":{"schema":{"properties":{"error":{"example":true,"type":"boolean","isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"description":"Human-readable error message describing what went wrong","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"Machine-readable error code for programmatic handling","type":"string","uniqueKey":"code","typeLabel":"string"},"parameters":{"additionalProperties":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"parameters.additionalProperties.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"parameters.additionalProperties.oneOf.0","typeLabel":"string[]"},{"type":"string","uniqueKey":"parameters.additionalProperties.oneOf.1","typeLabel":"string"}],"uniqueKey":"parameters.additionalProperties","typeLabel":"string[] | string"},"description":"Values that explain a coded error, such as the limit that was exceeded, the amount that remains, or the list of supported currencies.","type":"object","uniqueKey":"parameters","typeLabel":"object"}},"required":["error","message"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"\u003cstring>","code":"\u003cstring>","parameters":{}}}},"exampleType":"generated"}},"description":"Missing or invalid API key.","exampleType":"generated"},"712ef2cd-c8eb-4cde-8ef8-5c17991958ac":{"content":{"application/json":{"schema":{"properties":{"error":{"example":true,"type":"boolean","isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"description":"Human-readable error message describing what went wrong","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"Machine-readable error code for programmatic handling","type":"string","uniqueKey":"code","typeLabel":"string"},"parameters":{"additionalProperties":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"parameters.additionalProperties.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"parameters.additionalProperties.oneOf.0","typeLabel":"string[]"},{"type":"string","uniqueKey":"parameters.additionalProperties.oneOf.1","typeLabel":"string"}],"uniqueKey":"parameters.additionalProperties","typeLabel":"string[] | string"},"description":"Values that explain a coded error, such as the limit that was exceeded, the amount that remains, or the list of supported currencies.","type":"object","uniqueKey":"parameters","typeLabel":"object"}},"required":["error","message"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"\u003cstring>","code":"\u003cstring>","parameters":{}}}},"exampleType":"generated"}},"description":"Forbidden. Ensure the credentials are correct and the authentication source is allowed.","exampleType":"generated"},"91c5d302-f487-4df0-aeda-c35e12db47da":{"content":{"application/json":{"schema":{"properties":{"error":{"example":true,"type":"boolean","isRequired":true,"uniqueKey":"error","typeLabel":"boolean"},"message":{"description":"Human-readable error message describing what went wrong","type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"Machine-readable error code for programmatic handling","type":"string","uniqueKey":"code","typeLabel":"string"},"parameters":{"additionalProperties":{"oneOf":[{"type":"array","items":{"type":"string","uniqueKey":"parameters.additionalProperties.oneOf.0.items.[INDEX]","typeLabel":"string"},"uniqueKey":"parameters.additionalProperties.oneOf.0","typeLabel":"string[]"},{"type":"string","uniqueKey":"parameters.additionalProperties.oneOf.1","typeLabel":"string"}],"uniqueKey":"parameters.additionalProperties","typeLabel":"string[] | string"},"description":"Values that explain a coded error, such as the limit that was exceeded, the amount that remains, or the list of supported currencies.","type":"object","uniqueKey":"parameters","typeLabel":"object"}},"required":["error","message"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":true,"message":"\u003cstring>","code":"\u003cstring>","parameters":{}}}},"exampleType":"generated"}},"description":"Rate limit exceeded.","exampleType":"generated"}},"security":{"8596ba3f-376f-4bc4-9e2e-5bfb5b0c6380":{"apiKey":{"description":"API key required for authentication","in":"header","name":"X-API-KEY","type":"apiKey","scopes":[],"schemeName":"apiKey"}}},"servers":{"87fa3d6d-437d-48c5-8c30-749521673eea":{"description":"Staging environment (testnets)","url":"https://staging.crossmint.com/api"},"b2297053-6bcc-400a-bce0-bdc75db09bfb":{"description":"Production environment (mainnets)","url":"https://www.crossmint.com/api"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"API key required for authentication","in":"header","name":"X-API-KEY","type":"apiKey","scopes":[],"schemeName":"apiKey"},"schema":{"title":"X-API-KEY","type":"string","description":"API key required for authentication","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"X-API-KEY"}],"title":"apiKey"}]},"originalFileLocation":"api-reference/_open-api/PaymentMethods.json"},"subdomain":"crossmint","siteName":"Crossmint Docs","title":"List Bank Institutions - Crossmint Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-10T22:48:34.219Z","originalFileLocation":"offramp/api-reference/payment-methods/list-institutions.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=\"Retrieve the banks of a country and their institutionId values\">\u003cmeta data-mint-head name=\"application-name\" content=\"Crossmint 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/crossmint/-1hhMU0vchFPUD3H/_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/crossmint/-1hhMU0vchFPUD3H/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/crossmint/-1hhMU0vchFPUD3H/_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/crossmint/-1hhMU0vchFPUD3H/_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/crossmint/-1hhMU0vchFPUD3H/_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/crossmint/-1hhMU0vchFPUD3H/_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/crossmint/-1hhMU0vchFPUD3H/_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/crossmint/-1hhMU0vchFPUD3H/_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/crossmint/-1hhMU0vchFPUD3H/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List Bank Institutions - Crossmint Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve the banks of a country and their institutionId values\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Crossmint Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.crossmint.com/offramp/api-reference/payment-methods/list-institutions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://crossmint.mintlify.site/_mintlify/api/og/v2?division=Payment+Methods\u0026amp;title=List+Bank+Institutions\u0026amp;description=Retrieve+the+banks+of+a+country+and+their+institutionId+values\u0026amp;theme=b8bba0b38c114479513683ad\u0026amp;signature=feac1ee0ece7fe10170799b1ac014653af96a7f3c106d02b064f917384374cfa\">\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=\"List Bank Institutions - Crossmint Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve the banks of a country and their institutionId values\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://crossmint.mintlify.site/_mintlify/api/og/v2?division=Payment+Methods\u0026amp;title=List+Bank+Institutions\u0026amp;description=Retrieve+the+banks+of+a+country+and+their+institutionId+values\u0026amp;theme=b8bba0b38c114479513683ad\u0026amp;signature=feac1ee0ece7fe10170799b1ac014653af96a7f3c106d02b064f917384374cfa\">\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/crossmint/-1hhMU0vchFPUD3H/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Crossmint Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#36b37e\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.crossmint.com/offramp/api-reference/payment-methods/list-institutions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/offramp/api-reference/payment-methods/list-institutions.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.crossmint.com/#organization\",\"name\":\"Crossmint Docs\",\"url\":\"https://docs.crossmint.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/crossmint/a8gPOTKEuVFcSfC3/logo/crossmint-light.png?fit=max\u0026auto=format\u0026n=a8gPOTKEuVFcSfC3\u0026q=85\u0026s=8c2671e4c8f7da6956e1508bd68c2928\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.crossmint.com#website\",\"name\":\"Crossmint Docs\",\"url\":\"https://docs.crossmint.com\",\"publisher\":{\"@id\":\"https://docs.crossmint.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.crossmint.com/offramp/api-reference/payment-methods/list-institutions#webpage\",\"url\":\"https://docs.crossmint.com/offramp/api-reference/payment-methods/list-institutions\",\"name\":\"List Bank Institutions\",\"description\":\"Retrieve the banks of a country and their institutionId values\",\"dateModified\":\"2026-11-10T22:48:34.219Z\",\"isPartOf\":{\"@id\":\"https://docs.crossmint.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.crossmint.com/offramp/api-reference/payment-methods/list-institutions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.crossmint.com/offramp/api-reference/payment-methods/list-institutions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.crossmint.com/offramp/api-reference/create-order\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"REST\",\"item\":\"https://docs.crossmint.com/offramp/api-reference/create-order\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Payment Methods\",\"item\":\"https://docs.crossmint.com/offramp/api-reference/payment-methods/payment-method-object\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"List Bank Institutions\",\"item\":\"https://docs.crossmint.com/offramp/api-reference/payment-methods/list-institutions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.crossmint.com/offramp/api-reference/payment-methods/list-institutions#apireference\",\"headline\":\"List Bank Institutions\",\"name\":\"List Bank Institutions\",\"description\":\"Retrieve the banks of a country and their institutionId values\",\"url\":\"https://docs.crossmint.com/offramp/api-reference/payment-methods/list-institutions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.crossmint.com/offramp/api-reference/payment-methods/list-institutions#webpage\"},\"dateModified\":\"2026-11-10T22:48:34.219Z\",\"publisher\":{\"@id\":\"https://docs.crossmint.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.crossmint.com#website\"}}]}\u003c/script>","agentPointerHref":"/offramp/api-reference/payment-methods/list-institutions.md","siteName":"Crossmint Docs","nav":{"global":null,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":"/introduction/platform-overview"}]},{"tab":"Wallets","pages":[{"title":"Wallets","href":"/wallets/overview"}]},{"tab":"Identity","pages":[{"title":"Identity","href":"/identity/overview"}]},{"tab":"Stablecoin Orchestration","pages":[{"title":"Stablecoin Orchestration","href":"/stablecoin-orchestration/overview"}]},{"tab":"Checkout","pages":[{"title":"Checkout","href":"/payments/introduction"}]},{"tab":"Onramp","pages":[{"title":"Onramp","href":"/onramp/overview"}]},{"tab":"Offramp","groups":[{"group":"Introduction","pages":[{"title":"Overview","href":"/offramp/overview"},{"title":"Countries and Rails","sidebarTitle":"Countries \u0026 Rails","href":"/offramp/supported-countries-and-rails"}]},{"group":"Quickstarts ⚡","pages":[{"title":"REST API Quickstart","sidebarTitle":"REST API","href":"/offramp/quickstarts/rest-api"},{"title":"React Quickstart","sidebarTitle":"React","href":"/offramp/quickstarts/react"},{"title":"React Native Quickstart","sidebarTitle":"React Native","href":"/offramp/quickstarts/react-native"}]},{"group":"Concepts","pages":[{"title":"How It Works","href":"/offramp/concepts/how-it-works"},{"title":"KYC \u0026 Compliance","href":"/offramp/concepts/kyc-and-compliance"}]},{"group":"Guides","pages":[{"title":"UI Customization","href":"/offramp/guides/ui-customization"},{"title":"Handle Offramp Events and Errors","mode":"wide","href":"/offramp/guides/handle-events-and-errors"},{"title":"Import User KYC Data","href":"/offramp/guides/import-user-kyc-data"},{"title":"Manage Payment Methods","href":"/offramp/guides/collect-bank-accounts"},{"title":"Get an Offramp Quote","sidebarTitle":"Get a Quote","href":"/offramp/guides/preview-a-quote"},{"title":"Send or Receive an Exact Amount","href":"/offramp/guides/send-or-receive-an-exact-amount"},{"title":"Offramp Orders on Solana","href":"/offramp/guides/sign-deposit-solana"},{"title":"Manage Orders","href":"/offramp/guides/manage-orders"},{"title":"Institution IDs","mode":"wide","href":"/offramp/guides/institution-ids"},{"title":"Test a Failed Payout","href":"/offramp/guides/test-payout-failures"},{"title":"Launch in Production","href":"/offramp/guides/going-to-production"}]},{"group":"API Reference","pages":[{"group":"REST","icon":"brackets-curly","pages":[{"group":"Orders","pages":[{"title":"Create Order","openapi":"api-reference/_open-api/Orders.json POST /2022-06-09/orders","href":"/offramp/api-reference/create-order"},{"title":"Submit Deposit","openapi":"api-reference/_open-api/Orders.json POST /2022-06-09/orders/{orderId}/payment","href":"/offramp/api-reference/process-payment"},{"title":"Get Order","openapi":"api-reference/_open-api/Orders.json GET /2022-06-09/orders/{orderId}","href":"/offramp/api-reference/get-order"},{"title":"List Orders","openapi":"api-reference/_open-api/Orders.json GET /2022-06-09/orders","href":"/offramp/api-reference/list-orders"}]},{"group":"Offramp Sessions","pages":[{"title":"Create Offramp Session","openapi":"api-reference/_open-api/Orders.json POST /unstable/offramp-sessions","href":"/offramp/api-reference/create-offramp-session"}]},{"group":"Payment Methods","pages":[{"title":"The Payment Method Object","href":"/offramp/api-reference/payment-methods/payment-method-object"},{"title":"Create Payment Method","openapi":"api-reference/_open-api/PaymentMethods.json POST /2026-09-16/payment-methods","href":"/offramp/api-reference/payment-methods/create-payment-method"},{"title":"List Payment Methods by User","openapi":"api-reference/_open-api/PaymentMethods.json GET /2026-09-16/payment-methods","href":"/offramp/api-reference/payment-methods/list-payment-methods"},{"title":"Retrieve a Payment Method","openapi":"api-reference/_open-api/PaymentMethods.json GET /2026-09-16/payment-methods/{paymentMethodId}","href":"/offramp/api-reference/payment-methods/get-payment-method"},{"title":"Update a Payment Method","openapi":"api-reference/_open-api/PaymentMethods.json PATCH /2026-09-16/payment-methods/{paymentMethodId}","href":"/offramp/api-reference/payment-methods/update-payment-method"},{"title":"Delete a Payment Method","description":"Soft-delete a payout method. The record is retained for compliance but can no longer be used.","openapi":"api-reference/_open-api/PaymentMethods.json DELETE /2026-09-16/payment-methods/{paymentMethodId}","href":"/offramp/api-reference/payment-methods/delete-payment-method"},{"title":"List Bank Institutions","openapi":"api-reference/_open-api/PaymentMethods.json GET /2026-09-16/payment-methods/institutions","href":"/offramp/api-reference/payment-methods/list-institutions"}]}]},{"group":"React SDK","icon":"/images/icons/react.svg","pages":[{"title":"Get Started","description":"Installation and setup for the React SDK reference for Crossmint offramp","href":"/sdk-reference/offramp/react/get-started"},{"title":"Providers","href":"/sdk-reference/offramp/react/providers"},{"title":"Components","href":"/sdk-reference/offramp/react/components"},{"title":"Types and Utilities","href":"/sdk-reference/offramp/react/types"}]},{"group":"React Native SDK","icon":"/images/icons/react-native.svg","pages":[{"title":"Get Started","href":"/sdk-reference/offramp/react-native/get-started"},{"title":"Providers","href":"/sdk-reference/offramp/react-native/providers"},{"title":"Components","href":"/sdk-reference/offramp/react-native/components"},{"title":"Types and Utilities","href":"/sdk-reference/offramp/react-native/types"}]}]}]},{"tab":"Agents","pages":[{"title":"Agents","href":"/agents/overview"}]},{"tab":"Others","menu":[{"item":"Tokenization","pages":[{"title":"Tokenization","href":"/tokenization/introduction"}]}],"pages":[{"title":"Others","href":"/tokenization/introduction"}]}]},"basePath":"","title":"List Bank Institutions - Crossmint Docs","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"]}