Whether the card runs on a stored balance or a spending limit. The chosen model must be supported by the BIN (see balance_possibility / limit_possibility on GET /bins).
Reset period of the spending limit. Only for balance_type "limit"; defaults to "all_time" when a limit amount is given without a period. "per_transaction" caps each single operation instead of a rolling window.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Finup API","description":"Client-facing API documentation for Finup accounts, cards, users, and transactions.","colors":{"primary":"#3B66FF","light":"#6F8CFF","dark":"#2C54DE"},"logo":{"light":"https://mintcdn.com/finup-8fa91179/6xmKNxtArAPMxazm/logo/finup-blck.svg?fit=max\u0026auto=format\u0026n=6xmKNxtArAPMxazm\u0026q=85\u0026s=d171aa7226e7490f97b28c05f6fa49d2","dark":"https://mintcdn.com/finup-8fa91179/6xmKNxtArAPMxazm/logo/finup-wht.svg?fit=max\u0026auto=format\u0026n=6xmKNxtArAPMxazm\u0026q=85\u0026s=a0f341c73f2de832a19ea43bcc669920"},"favicon":"https://mintcdn.com/finup-8fa91179/6xmKNxtArAPMxazm/favicon.svg?fit=max\u0026auto=format\u0026n=6xmKNxtArAPMxazm\u0026q=85\u0026s=6e4a877a548f60c254c0cdfab80307b0","api":{"openapi":"openapi.json","playground":{"display":"interactive","proxy":true},"examples":{"defaults":"required","languages":["curl","javascript","python"]}},"navbar":{"links":[{"href":"https://app.finup.io","label":"App"}]},"footer":{"socials":{"website":"https://finup.io"}},"icons":{"library":"lucide"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"finup-8fa91179","hasAudioNarration":false,"actualSubdomain":"finup-8fa91179","customDomains":["docs.finup.io"],"gitSource":{"type":"github","owner":"finup-development","repo":"mintlify-docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"collectionId":"0ec38c5f-b1ae-4884-9655-0a259d4e3edf","liveDeploymentHistoryId":"6ae1ddcf8ead5bbc3c1c885b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae1ddcf8ead5bbc3c1c885b"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae1ddcf8ead5bbc3c1c885b","clientVersion":"0.0.4074","searchFilterCounts":[{"language":"default","tag":"API reference","count":17},{"language":"default","tag":"Cards","count":8},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Start","count":6},{"language":"default","tag":"Transactions","count":4},{"language":"default","tag":"Accounts","count":3},{"language":"default","tag":"Overview","count":2},{"language":"default","tag":"MCP","count":1}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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":"vite-origin","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},{"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},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/cards/issue-cards","slug":"/api-reference/cards/issue-cards","pageMetadata":{"title":"Issue cards","description":"Issues `quantity` cards on one BIN. `balance_type` is required and must be supported by the BIN.","deprecated":null,"version":null,"openapi":"/openapi.json post /cards","href":"/api-reference/cards/issue-cards","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Issues \", _jsx(_components.code, {\n children: \"quantity\"\n }), \" cards on one BIN. \", _jsx(_components.code, {\n children: \"balance_type\"\n }), \" is required and must be supported by the BIN.\"]\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":"Issue cards","description":"Issues `quantity` cards on one BIN. `balance_type` is required and must be supported by the BIN.","deprecated":null,"version":null,"openapi":"/openapi.json post /cards","href":"/api-reference/cards/issue-cards","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Cards"],"summary":"Issue cards","description":"Issues `quantity` cards on one BIN. `balance_type` is required and must be supported by the BIN.","security":["408ba404-4b08-4daa-92ed-98b4814dce10"],"requestBody":"02b7d33a-7cdd-4eb3-9625-51d916949323","responses":{"201":"6259b24f-155d-45ce-a76f-5ca2591618ee","401":"7f6f9da1-3407-45a4-974c-b2ee3b6a0b76","403":"0b5a9d6b-a566-40b6-b3a0-f02980448a78","404":"067589b4-5661-4083-957b-787b3a0cc4e3","420":"c36529f4-7db4-4557-a432-657e52f05dfe"},"method":"post","type":"path","servers":["18d0eb62-b3b9-43a3-8953-4f6751b3c287"],"path":"/cards","baseUrlOptions":["https://api.finup.io/backend"],"title":"Issue cards","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["bin_id","name","balance_type"],"properties":{"bin_id":{"type":"string","example":"67c401f9a5b7cde210f44567","isRequired":true,"uniqueKey":"bin_id","typeLabel":"string"},"balance_type":{"type":"string","enum":["balance","limit"],"example":"limit","description":"Whether the card runs on a stored balance or a spending limit. The chosen model must be supported by the BIN (see balance_possibility / limit_possibility on GET /bins).","isRequired":true,"uniqueKey":"balance_type","typeLabel":"enum\u003cstring>"},"name":{"type":"string","example":"Marketing card","isRequired":true,"uniqueKey":"name","typeLabel":"string"},"user_id":{"type":"string","example":"67fc3d09766d7a2c1fafef99","uniqueKey":"user_id","typeLabel":"string"},"notes":{"type":"string","example":"Q3 campaigns","uniqueKey":"notes","typeLabel":"string"},"balance_threshold":{"type":"number","example":25,"uniqueKey":"balance_threshold","typeLabel":"number"},"top_up_amount":{"type":"number","example":100,"uniqueKey":"top_up_amount","typeLabel":"number"},"quantity":{"type":"integer","minimum":1,"example":1,"description":"Number of cards to issue. Either quantity or the legacy alias amount must be present.","uniqueKey":"quantity","typeLabel":"integer"},"amount":{"type":"integer","minimum":1,"example":1,"description":"Legacy alias for quantity. Prefer quantity.","uniqueKey":"amount","typeLabel":"integer"},"limit_amount":{"oneOf":[{"type":"number","maximum":1000000,"example":500,"description":"Spending limit for balance_type \"limit\". null = unlimited card, 0 = card cannot spend. Ignored for balance cards.","uniqueKey":"limit_amount.oneOf.0","typeLabel":"number"},{"type":"null","maximum":1000000,"example":500,"description":"Spending limit for balance_type \"limit\". null = unlimited card, 0 = card cannot spend. Ignored for balance cards.","uniqueKey":"limit_amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"limit_amount","typeLabel":"number | null"},"limit_period":{"type":"string","enum":["one_day","seven_days","thirty_days","all_time","per_transaction"],"example":"thirty_days","description":"Reset period of the spending limit. Only for balance_type \"limit\"; defaults to \"all_time\" when a limit amount is given without a period. \"per_transaction\" caps each single operation instead of a rolling window.","uniqueKey":"limit_period","typeLabel":"enum\u003cstring>"},"promo":{"type":"string","example":"WELCOME","uniqueKey":"promo","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"bin_id":"67c401f9a5b7cde210f44567","balance_type":"limit","name":"Marketing card","user_id":"67fc3d09766d7a2c1fafef99","notes":"Q3 campaigns","balance_threshold":25,"top_up_amount":100,"quantity":1,"amount":1,"limit_amount":500,"limit_period":"thirty_days","promo":"WELCOME"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"6259b24f-155d-45ce-a76f-5ca2591618ee":{"description":"Success","content":{"application/json":{"schema":{"type":"object","required":["result"],"properties":{"result":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","example":"67c48f6fc8614632e0b338fc","uniqueKey":"result.items.[INDEX].id","typeLabel":"string"},"name":{"type":"string","example":"Marketing card","uniqueKey":"result.items.[INDEX].name","typeLabel":"string"},"bin_id":{"type":"string","example":"67bcf2abf8e89d31c5f8995e","uniqueKey":"result.items.[INDEX].bin_id","typeLabel":"string"},"notes":{"type":"string","example":"Q3 campaigns","uniqueKey":"result.items.[INDEX].notes","typeLabel":"string"},"account":{"type":"string","example":"67c401f9a5b7cde210f44567","uniqueKey":"result.items.[INDEX].account","typeLabel":"string"},"user":{"type":"string","example":"67aa1b2c3d4e5f6789abcdef","uniqueKey":"result.items.[INDEX].user","typeLabel":"string"},"status":{"type":"string","enum":["blocked","closed","closing","enabled","freezed","freezing","processing","unreezing"],"example":"enabled","uniqueKey":"result.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"category":{"type":"string","enum":["business","platinum","advertising"],"example":"business","uniqueKey":"result.items.[INDEX].category","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","example":"USD","uniqueKey":"result.items.[INDEX].currency","typeLabel":"string"},"masked_PAN":{"oneOf":[{"type":"string","example":"1234 56•• •••• 5678","uniqueKey":"result.items.[INDEX].masked_PAN.oneOf.0","typeLabel":"string"},{"type":"null","example":"1234 56•• •••• 5678","uniqueKey":"result.items.[INDEX].masked_PAN.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.items.[INDEX].masked_PAN","typeLabel":"string | null"},"EXP":{"type":"string","example":"**/**","uniqueKey":"result.items.[INDEX].EXP","typeLabel":"string"},"balance":{"type":"number","example":50,"uniqueKey":"result.items.[INDEX].balance","typeLabel":"number"},"deposit":{"type":"number","example":1000,"description":"Lifetime total deposited to the card.","uniqueKey":"result.items.[INDEX].deposit","typeLabel":"number"},"withdraw":{"type":"number","example":500,"description":"Lifetime total withdrawn from the card.","uniqueKey":"result.items.[INDEX].withdraw","typeLabel":"number"},"balance_type":{"oneOf":[{"type":"string","enum":["balance","limit"],"example":"limit","uniqueKey":"result.items.[INDEX].balance_type.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["balance","limit"],"example":"limit","uniqueKey":"result.items.[INDEX].balance_type.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.items.[INDEX].balance_type","typeLabel":"enum\u003cstring> | null"},"limit_amount":{"oneOf":[{"type":"number","example":500,"description":"Spending limit, or null for balance cards and unlimited limit cards.","uniqueKey":"result.items.[INDEX].limit_amount.oneOf.0","typeLabel":"number"},{"type":"null","example":500,"description":"Spending limit, or null for balance cards and unlimited limit cards.","uniqueKey":"result.items.[INDEX].limit_amount.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.items.[INDEX].limit_amount","typeLabel":"number | null"},"limit_period":{"oneOf":[{"type":"string","enum":["one_day","seven_days","thirty_days","all_time","per_transaction"],"example":"thirty_days","uniqueKey":"result.items.[INDEX].limit_period.oneOf.0","typeLabel":"enum\u003cstring>"},{"type":"null","enum":["one_day","seven_days","thirty_days","all_time","per_transaction"],"example":"thirty_days","uniqueKey":"result.items.[INDEX].limit_period.oneOf.1","typeLabel":"null"}],"uniqueKey":"result.items.[INDEX].limit_period","typeLabel":"enum\u003cstring> | null"},"balance_possibility":{"type":"boolean","example":true,"uniqueKey":"result.items.[INDEX].balance_possibility","typeLabel":"boolean"},"limit_possibility":{"type":"boolean","example":true,"uniqueKey":"result.items.[INDEX].limit_possibility","typeLabel":"boolean"},"auto_deposit":{"type":"boolean","example":false,"uniqueKey":"result.items.[INDEX].auto_deposit","typeLabel":"boolean"},"balance_threshold":{"type":"number","example":25,"uniqueKey":"result.items.[INDEX].balance_threshold","typeLabel":"number"},"top_up_amount":{"type":"number","example":100,"uniqueKey":"result.items.[INDEX].top_up_amount","typeLabel":"number"},"created_at":{"type":"string","format":"date-time","uniqueKey":"result.items.[INDEX].created_at","typeLabel":"string\u003cdate-time>"},"updated_at":{"type":"string","format":"date-time","uniqueKey":"result.items.[INDEX].updated_at","typeLabel":"string\u003cdate-time>"},"3ds":{"type":"boolean","example":true,"uniqueKey":"result.items.[INDEX].3ds","typeLabel":"boolean"},"3ds_password":{"type":"string","example":"123456","description":"Static 3DS password of the BIN. Same visibility as PAN, and only on 3DS BINs.","uniqueKey":"result.items.[INDEX].3ds_password","typeLabel":"string"},"address":{"type":"string","example":"2381 Zanker Rd Ste 110, San Jose, CA, 95131, US","uniqueKey":"result.items.[INDEX].address","typeLabel":"string"},"PAN":{"type":"string","example":"1234 5678 1234 5678","description":"Full card number. Only on GET /cards/{card_id}, for the card holder or a member with `can_manage_team_cards`, and never for a closed card.","uniqueKey":"result.items.[INDEX].PAN","typeLabel":"string"},"CVV":{"type":"string","example":"123","description":"Card CVV. Same visibility as PAN.","uniqueKey":"result.items.[INDEX].CVV","typeLabel":"string"},"PIN":{"type":"string","example":"1234","description":"Card PIN when the card has one. Same visibility as PAN.","uniqueKey":"result.items.[INDEX].PIN","typeLabel":"string"}},"uniqueKey":"result.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"result","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"result":[{"id":"67c48f6fc8614632e0b338fc","name":"Marketing card","bin_id":"67bcf2abf8e89d31c5f8995e","notes":"Q3 campaigns","account":"67c401f9a5b7cde210f44567","user":"67aa1b2c3d4e5f6789abcdef","status":"enabled","category":"business","currency":"USD","masked_PAN":"1234 56•• •••• 5678","EXP":"**/**","balance":50,"deposit":1000,"withdraw":500,"balance_type":"limit","limit_amount":500,"limit_period":"thirty_days","balance_possibility":true,"limit_possibility":true,"auto_deposit":false,"balance_threshold":25,"top_up_amount":100,"created_at":"2023-11-07T05:31:56Z","updated_at":"2023-11-07T05:31:56Z","3ds":true,"3ds_password":"123456","address":"2381 Zanker Rd Ste 110, San Jose, CA, 95131, US","PAN":"1234 5678 1234 5678","CVV":"123","PIN":"1234"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"7f6f9da1-3407-45a4-974c-b2ee3b6a0b76":{"description":"Missing or invalid credentials","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"0b5a9d6b-a566-40b6-b3a0-f02980448a78":{"description":"Insufficient permission for this operation","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"067589b4-5661-4083-957b-787b3a0cc4e3":{"description":"Resource not found","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}},"c36529f4-7db4-4557-a432-657e52f05dfe":{"description":"Insufficient balance","content":{"_mintlify/placeholder":{"schema":{"type":"object","description":""}}}}},"security":{"408ba404-4b08-4daa-92ed-98b4814dce10":{"apiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"apiKeyAuth"}}},"servers":{"18d0eb62-b3b9-43a3-8953-4f6751b3c287":{"url":"https://api.finup.io/backend","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","scopes":[],"schemeName":"apiKeyAuth"},"schema":{"title":"x-api-key","type":"string","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKeyAuth","name":"x-api-key"}],"title":"apiKeyAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"finup-8fa91179","siteName":"Finup API","title":"Issue cards - Finup API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-28T11:34:44.706Z","originalFileLocation":"api-reference/cards/issue-cards.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=\"Issues quantity cards on one BIN. balance_type is required and must be supported by the BIN.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Finup API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_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/finup-8fa91179/efMM26EDZKsLZWgY/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Issue cards - Finup API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Issues quantity cards on one BIN. balance_type is required and must be supported by the BIN.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Finup API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.finup.io/api-reference/cards/issue-cards\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://finup-8fa91179.mintlify.site/_mintlify/api/og/v2?division=Cards\u0026amp;title=Issue+cards\u0026amp;description=Issues+%60quantity%60+cards+on+one+BIN.+%60balance_type%60+is+required+and+must+be+supported+by+the+BIN.\u0026amp;theme=3a9324784f24285b2fa50338\u0026amp;signature=92e806bce49be1b0a1b0169adc48bf4d009672140ed324a0698731630ee3ea47\">\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=\"Issue cards - Finup API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Issues quantity cards on one BIN. balance_type is required and must be supported by the BIN.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://finup-8fa91179.mintlify.site/_mintlify/api/og/v2?division=Cards\u0026amp;title=Issue+cards\u0026amp;description=Issues+%60quantity%60+cards+on+one+BIN.+%60balance_type%60+is+required+and+must+be+supported+by+the+BIN.\u0026amp;theme=3a9324784f24285b2fa50338\u0026amp;signature=92e806bce49be1b0a1b0169adc48bf4d009672140ed324a0698731630ee3ea47\">\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/finup-8fa91179/efMM26EDZKsLZWgY/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Finup API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3B66FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.finup.io/api-reference/cards/issue-cards\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/cards/issue-cards.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.finup.io/#organization\",\"name\":\"Finup API\",\"url\":\"https://docs.finup.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/finup-8fa91179/6xmKNxtArAPMxazm/logo/finup-blck.svg?fit=max\u0026auto=format\u0026n=6xmKNxtArAPMxazm\u0026q=85\u0026s=d171aa7226e7490f97b28c05f6fa49d2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.finup.io#website\",\"name\":\"Finup API\",\"url\":\"https://docs.finup.io\",\"publisher\":{\"@id\":\"https://docs.finup.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.finup.io/api-reference/cards/issue-cards#webpage\",\"url\":\"https://docs.finup.io/api-reference/cards/issue-cards\",\"name\":\"Issue cards\",\"description\":\"Issues quantity cards on one BIN. balance_type is required and must be supported by the BIN.\",\"dateModified\":\"2026-10-28T11:34:44.706Z\",\"isPartOf\":{\"@id\":\"https://docs.finup.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.finup.io/api-reference/cards/issue-cards#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.finup.io/api-reference/cards/issue-cards#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Finup API\",\"item\":\"https://docs.finup.io\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Issue cards\",\"item\":\"https://docs.finup.io/api-reference/cards/issue-cards\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.finup.io/api-reference/cards/issue-cards#apireference\",\"headline\":\"Issue cards\",\"name\":\"Issue cards\",\"description\":\"Issues quantity cards on one BIN. balance_type is required and must be supported by the BIN.\",\"url\":\"https://docs.finup.io/api-reference/cards/issue-cards\",\"mainEntityOfPage\":{\"@id\":\"https://docs.finup.io/api-reference/cards/issue-cards#webpage\"},\"dateModified\":\"2026-10-28T11:34:44.706Z\",\"publisher\":{\"@id\":\"https://docs.finup.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.finup.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Finup API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Finup API","nav":{"global":null,"tabs":[{"tab":"Guides","icon":"book-open","pages":[{"title":"Guides","href":"/introduction"}]},{"tab":"API reference","icon":"square-terminal","groups":[{"group":"Overview","pages":[{"title":"API reference overview","icon":"square-terminal","href":"/reference/overview"},{"title":"Users","icon":"user","href":"/reference/users"}]},{"group":"Accounts","pages":[{"title":"Create account","deprecated":null,"version":null,"openapi":"/openapi.json post /accounts","href":"/api-reference/accounts/create-account"},{"title":"Get account capabilities","deprecated":null,"version":null,"openapi":"/openapi.json get /account","href":"/api-reference/accounts/get-account-capabilities"},{"title":"Get card types available for the account","deprecated":null,"version":null,"openapi":"/openapi.json get /bins","href":"/api-reference/accounts/get-card-types-available-for-the-account"}]},{"group":"Transactions","pages":[{"title":"List account transactions","deprecated":null,"version":null,"openapi":"/openapi.json post /transactions","href":"/api-reference/transactions/list-account-transactions"},{"title":"Refund a deposit blocked by the AML check","deprecated":null,"version":null,"openapi":"/openapi.json post /transactions/{transaction_id}/aml-refund","href":"/api-reference/transactions/refund-a-deposit-blocked-by-the-aml-check"},{"title":"Count filtered transactions","deprecated":null,"version":null,"openapi":"/openapi.json post /transactions/count","href":"/api-reference/transactions/count-filtered-transactions"},{"title":"Summarize filtered transactions","description":"Aggregates the whole filtered set, not just the current page. Card funding and same-account member transfers are net-zero within the account and are excluded from both spent and incoming.","deprecated":null,"version":null,"openapi":"/openapi.json post /transactions/summary","href":"/api-reference/transactions/summarize-filtered-transactions"}]},{"group":"Cards","pages":[{"title":"Issue cards","deprecated":null,"version":null,"openapi":"/openapi.json post /cards","href":"/api-reference/cards/issue-cards"},{"title":"List account cards","description":"Filters and pagination are both optional; pagination defaults to page 1, 50 per page. Money fields are decimal strings on this endpoint.\n\n`sort_by`: created_at | balance | name | holder | tags | spend | transactions | declined_transactions | decline_rate | fees | average_transaction_amount. holder sorts by the owner's \"first last\" name, tags by the alphabetically first tag name (case-insensitive). Metric sorts read `metrics_window` (thirty_days when omitted), a card without metrics counts as 0. createdAt desc breaks ties.","deprecated":null,"version":null,"openapi":"/openapi.json post /cards/get","href":"/api-reference/cards/list-account-cards"},{"title":"Get card details","deprecated":null,"version":null,"openapi":"/openapi.json get /cards/{card_id}","href":"/api-reference/cards/get-card-details"},{"title":"Deposit funds to card","deprecated":null,"version":null,"openapi":"/openapi.json post /card/{card_id}/deposit","href":"/api-reference/cards/deposit-funds-to-card"},{"title":"Withdraw funds from card","deprecated":null,"version":null,"openapi":"/openapi.json post /card/{card_id}/withdraw","href":"/api-reference/cards/withdraw-funds-from-card"},{"title":"Freeze cards","deprecated":null,"version":null,"openapi":"/openapi.json patch /cards/freeze","href":"/api-reference/cards/freeze-cards"},{"title":"Unfreeze cards","deprecated":null,"version":null,"openapi":"/openapi.json patch /cards/unfreeze","href":"/api-reference/cards/unfreeze-cards"},{"title":"Close cards","deprecated":null,"version":null,"openapi":"/openapi.json patch /cards/close","href":"/api-reference/cards/close-cards"}]}]}]},"basePath":"","title":"Issue cards - Finup API","buildId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","deploymentId":"dpl_BLQvU86QFwq3AhPofSTw6q8dGWKm","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-Myd8dsju.js","utils-C2HkQgW0.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-8rSppmTv.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B6MjiCFm.js","snippetPresets-DwrSAONL.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-1-a5UQKQ.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C541m7wZ.js","shallow-CWELCZ77.js","getApiPlaygroundDisplay-CTo5Zn03.js","CodeSnippet-D--dzvnl.js","CodeSnippets-DM3cXEDh.js","Page-CxAy5y67.js","getPastedJson-C-VECgcL.js","icon-BPq2-Mg3.js","MethodPill-D9J5cUHd.js","DuplicateIcon-BqHaxUnD.js","createIcon-CIbcZHp9.js","DynamicMarkdown-BKiHAm_d.js","SectionHeading-DstQXt3H.js","axios-vUo_bRtp.js","Markdown-CpxgzsKA.js","clsx-C5EfhVm0.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CJ9Oly2E.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Mk6P3qvh.js"]}