Reads a card’s spending limits, the saved version to send when you change them, and how much of each limit the card has used. Requires a key with org.read to read limits or org.write to set them, such as your platform key, and the buyer’s ID in the sapiom-tenant header. Buyer keys have neither permission.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Sapiom Pay","description":"Let your AI agent buy for each of your users with their own saved card. Sapiom vaults each user's card, authorizes every transaction against real checkout facts, and fills the card into checkout without your agent ever seeing it.","colors":{"primary":"#16A34A","light":"#07C983","dark":"#15803D"},"logo":{"light":"https://mintcdn.com/sapiom-1f975ca2/K4zW5IjQAMJutZvi/logo/light.svg?fit=max\u0026auto=format\u0026n=K4zW5IjQAMJutZvi\u0026q=85\u0026s=37d04ab53c9792ff376364fd56a2799e","dark":"https://mintcdn.com/sapiom-1f975ca2/K4zW5IjQAMJutZvi/logo/dark.svg?fit=max\u0026auto=format\u0026n=K4zW5IjQAMJutZvi\u0026q=85\u0026s=bee7a03b976b9be9e5944daf9ca380ba"},"favicon":"https://mintcdn.com/sapiom-1f975ca2/7k2CTIHfQZNyln5W/favicon.svg?fit=max\u0026auto=format\u0026n=7k2CTIHfQZNyln5W\u0026q=85\u0026s=ffac7db148c05d663b25d3e420b2a24d","api":{"playground":{"display":"simple"}},"navbar":{"primary":{"type":"button","label":"Request access","href":"/request-access"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"markdown":{"instructions":["Sapiom Pay is for platforms whose agent shops for many end users. Each end user is a buyer with their own Sapiom key and saved cards.","Use the buyer's key for every call made on that buyer's behalf. Never use one buyer's key for another user, and never give the agent the platform key.","Agents call the hosted MCP tools at https://api.sapiom.ai/v1/mcp. Backends call the REST API at https://api.sapiom.ai/v1. Both take the key in an x-api-key header.","Never ask a buyer for a card number, expiry date or CVV in chat. Buyers enter card details only on Sapiom's hosted pages.","Follow the nextAction in each transaction result. Action links are secrets for the intended buyer only.","Use one idempotencyKey per transaction. After a timeout, retry with the same key. Never start a new transaction to escape an uncertain outcome.","Report an order as placed only when order.outcome is confirmed. If it is unknown, stop and hand off to a person."]},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"sapiom-1f975ca2","hasAudioNarration":false,"actualSubdomain":"sapiom-1f975ca2","customDomains":["docs.sapiom.ai"],"gitSource":{"type":"github","owner":"sapiom","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6adc09fb88e4302084f07b26","collectionId":"63ee2a9b-edcc-4ec4-bdef-e6e8dece8b95","liveDeploymentHistoryId":"6adc09fb88e4302084f07b26","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adc2ddc1885992e09c7803b","clientVersion":"0.0.3964","searchFilterCounts":[{"language":"default","tag":"API reference","count":26},{"language":"default","tag":"REST API","count":22},{"language":"default","tag":"Docs","count":14},{"language":"default","tag":"Transactions","count":9},{"language":"default","tag":"Cards","count":8},{"language":"default","tag":"Buyers","count":6},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"Browser checkout","count":3},{"language":"default","tag":"MCP and SDK","count":2},{"language":"default","tag":"Early access","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"editor-v7-file-tree","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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-private-page-search","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":"editor-nav-generations","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":"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":"editor-agent-model-picker","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":"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}],"isAtlas":false,"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/spending-limits/get-spending-limits","slug":"/api-reference/spending-limits/get-spending-limits","pageMetadata":{"title":"Get spending limits","description":"Reads a card's spending limits, the saved `version` to send when you change them, and how much of each limit the card has used. Requires a key with `org.read` to read limits or `org.write` to set them, such as your [platform key](/api-reference/overview#authentication), and the buyer's ID in the `sapiom-tenant` header. Buyer keys have neither permission.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payment-cards/{cardId}/spending-limits","href":"/api-reference/spending-limits/get-spending-limits","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 a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Reads a card’s spending limits, the saved \", _jsx(_components.code, {\n children: \"version\"\n }), \" to send when you change them, and how much of each limit the card has used. Requires a key with \", _jsx(_components.code, {\n children: \"org.read\"\n }), \" to read limits or \", _jsx(_components.code, {\n children: \"org.write\"\n }), \" to set them, such as your \", _jsx(_components.a, {\n href: \"/api-reference/overview#authentication\",\n children: \"platform key\"\n }), \", and the buyer’s ID in the \", _jsx(_components.code, {\n children: \"sapiom-tenant\"\n }), \" header. Buyer keys have neither permission.\"]\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 spending limits","description":"Reads a card's spending limits, the saved `version` to send when you change them, and how much of each limit the card has used. Requires a key with `org.read` to read limits or `org.write` to set them, such as your [platform key](/api-reference/overview#authentication), and the buyer's ID in the `sapiom-tenant` header. Buyer keys have neither permission.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payment-cards/{cardId}/spending-limits","href":"/api-reference/spending-limits/get-spending-limits","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"CardLimitsController_get","parameters":["fad598ed-17f6-4727-9ef4-46b76c3b9c5b","bd7344db-5ccc-43d1-b926-6d2ed36fdf1c"],"responses":{"200":"2ac24eff-2329-4278-8a01-c7f05b38ea20"},"security":["e5c38066-a141-4b0d-adaa-71a7c9090353"],"summary":"Get spending limits","tags":["Spending limits"],"description":"Reads a card's spending limits, the saved `version` to send when you change them, and how much of each limit the card has used. Requires a key with `org.read` to read limits or `org.write` to set them, such as your [platform key](/api-reference/overview#authentication), and the buyer's ID in the `sapiom-tenant` header. Buyer keys have neither permission.","method":"get","type":"path","servers":["129d4bde-9564-498b-9b32-242ff84fee16"],"path":"/v1/payment-cards/{cardId}/spending-limits","baseUrlOptions":["https://api.sapiom.ai"],"title":"Get spending limits","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"fad598ed-17f6-4727-9ef4-46b76c3b9c5b":{"name":"cardId","required":true,"in":"path","schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}},"bd7344db-5ccc-43d1-b926-6d2ed36fdf1c":{"name":"sapiom-tenant","in":"header","required":true,"schema":{"type":"string","isRequired":true,"description":"The buyer's ID: the `id` from [Create a buyer](/api-reference/buyers/create-a-buyer).","uniqueKey":"","typeLabel":"string"},"description":"The buyer's ID: the `id` from [Create a buyer](/api-reference/buyers/create-a-buyer)."}},"responses":{"2ac24eff-2329-4278-8a01-c7f05b38ea20":{"description":"","content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["version","purchaseLimit","recurringLimit","customLimit","ruleId","status","evaluatedAt","configurationActive","additionalLimits","usage"],"properties":{"version":{"type":"integer","minimum":0,"maximum":2147483646,"description":"Current saved version; 0 for first configuration.","isRequired":true,"uniqueKey":"version","typeLabel":"integer"},"purchaseLimit":{"oneOf":[{"type":"object","additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"string","pattern":"^(0|[1-9]\\d{0,17})(\\.\\d{1,2})?$","example":"100.00","description":"Positive USD decimal amount; at most two fractional digits.","isRequired":true,"uniqueKey":"purchaseLimit.oneOf.0.amount","typeLabel":"string"},"currency":{"type":"string","enum":["USD"],"isRequired":true,"uniqueKey":"purchaseLimit.oneOf.0.currency","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"purchaseLimit.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["amount","currency"],"properties":{"amount":{"type":"string","pattern":"^(0|[1-9]\\d{0,17})(\\.\\d{1,2})?$","example":"100.00","description":"Positive USD decimal amount; at most two fractional digits."},"currency":{"type":"string","enum":["USD"]}},"isRequired":true,"uniqueKey":"purchaseLimit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"purchaseLimit","typeLabel":"object | null"},"recurringLimit":{"oneOf":[{"type":"object","additionalProperties":false,"required":["amount","currency","period"],"properties":{"amount":{"type":"string","pattern":"^(0|[1-9]\\d{0,17})(\\.\\d{1,2})?$","example":"100.00","description":"Positive USD decimal amount; at most two fractional digits.","isRequired":true,"uniqueKey":"recurringLimit.oneOf.0.amount","typeLabel":"string"},"currency":{"type":"string","enum":["USD"],"isRequired":true,"uniqueKey":"recurringLimit.oneOf.0.currency","typeLabel":"enum\u003cstring>"},"period":{"type":"string","enum":["week","month","year"],"isRequired":true,"uniqueKey":"recurringLimit.oneOf.0.period","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"recurringLimit.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["amount","currency","period"],"properties":{"amount":{"type":"string","pattern":"^(0|[1-9]\\d{0,17})(\\.\\d{1,2})?$","example":"100.00","description":"Positive USD decimal amount; at most two fractional digits."},"currency":{"type":"string","enum":["USD"]},"period":{"type":"string","enum":["week","month","year"]}},"isRequired":true,"uniqueKey":"recurringLimit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"recurringLimit","typeLabel":"object | null"},"customLimit":{"oneOf":[{"type":"object","additionalProperties":false,"required":["amount","currency","startDate","endDate"],"properties":{"amount":{"type":"string","pattern":"^(0|[1-9]\\d{0,17})(\\.\\d{1,2})?$","example":"100.00","description":"Positive USD decimal amount; at most two fractional digits.","isRequired":true,"uniqueKey":"customLimit.oneOf.0.amount","typeLabel":"string"},"currency":{"type":"string","enum":["USD"],"isRequired":true,"uniqueKey":"customLimit.oneOf.0.currency","typeLabel":"enum\u003cstring>"},"startDate":{"type":"string","format":"date","description":"UTC calendar date, inclusive.","isRequired":true,"uniqueKey":"customLimit.oneOf.0.startDate","typeLabel":"string\u003cdate>"},"endDate":{"type":"string","format":"date","description":"UTC calendar date, inclusive.","isRequired":true,"uniqueKey":"customLimit.oneOf.0.endDate","typeLabel":"string\u003cdate>"}},"isRequired":true,"uniqueKey":"customLimit.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["amount","currency","startDate","endDate"],"properties":{"amount":{"type":"string","pattern":"^(0|[1-9]\\d{0,17})(\\.\\d{1,2})?$","example":"100.00","description":"Positive USD decimal amount; at most two fractional digits."},"currency":{"type":"string","enum":["USD"]},"startDate":{"type":"string","format":"date","description":"UTC calendar date, inclusive."},"endDate":{"type":"string","format":"date","description":"UTC calendar date, inclusive."}},"isRequired":true,"uniqueKey":"customLimit.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"customLimit","typeLabel":"object | null"},"ruleId":{"oneOf":[{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"ruleId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","isRequired":true,"uniqueKey":"ruleId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"ruleId","typeLabel":"string\u003cuuid> | null"},"status":{"type":"string","enum":["active","paused","removed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"evaluatedAt":{"format":"date-time","type":"string","isRequired":true,"uniqueKey":"evaluatedAt","typeLabel":"string\u003cdate-time>"},"configurationActive":{"type":"boolean","description":"Effective configuration exists; each proposed purchase still must pass all applicable limits.","isRequired":true,"uniqueKey":"configurationActive","typeLabel":"boolean"},"additionalLimits":{"type":"array","description":"Other matching or conditional payment rules. Managed through Rules; excluded from these settings slots.","items":{"type":"object","additionalProperties":false,"required":["ruleId","constraintId","name","scope","limit","groupBy","usage"],"properties":{"ruleId":{"format":"uuid","type":"string","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].ruleId","typeLabel":"string\u003cuuid>"},"constraintId":{"format":"uuid","type":"string","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].constraintId","typeLabel":"string\u003cuuid>"},"name":{"type":"string","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].name","typeLabel":"string"},"scope":{"type":"string","enum":["match","unavailable"],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].scope","typeLabel":"enum\u003cstring>"},"limit":{"type":"object","additionalProperties":false,"required":["kind","amount","currency"],"properties":{"kind":{"type":"string","enum":["money"],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].limit.kind","typeLabel":"enum\u003cstring>"},"amount":{"type":"string","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].limit.amount","typeLabel":"string"},"currency":{"type":"string","enum":["USD"],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].limit.currency","typeLabel":"enum\u003cstring>"}},"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].limit","typeLabel":"object"},"groupBy":{"type":"array","items":{"type":"string","enum":["agent","trace","service","paymentCardId"],"uniqueKey":"additionalLimits.items.[INDEX].groupBy.items.[INDEX]","typeLabel":"enum\u003cstring>"},"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].groupBy","typeLabel":"enum\u003cstring>[]"},"usage":{"oneOf":[{"type":"object","additionalProperties":false,"required":["available","state","currency","startInclusive","endExclusive","resetAt","spent","pendingCommitted","used","remaining"],"properties":{"available":{"type":"boolean","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.available","typeLabel":"boolean"},"state":{"type":"string","enum":["active","future","expired","inactive","unavailable"],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.state","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","enum":["USD"],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.currency","typeLabel":"enum\u003cstring>"},"startInclusive":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.startInclusive.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.startInclusive.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.startInclusive","typeLabel":"string\u003cdate-time> | null"},"endExclusive":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.endExclusive.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.endExclusive.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.endExclusive","typeLabel":"string\u003cdate-time> | null"},"resetAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.resetAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.resetAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.resetAt","typeLabel":"string\u003cdate-time> | null"},"spent":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.spent.oneOf.0","typeLabel":"string"},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.spent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.spent","typeLabel":"string | null"},"pendingCommitted":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.pendingCommitted.oneOf.0","typeLabel":"string"},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.pendingCommitted.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.pendingCommitted","typeLabel":"string | null"},"used":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.used.oneOf.0","typeLabel":"string"},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.used.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.used","typeLabel":"string | null"},"remaining":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.remaining.oneOf.0","typeLabel":"string"},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0.remaining","typeLabel":"string | null"}},"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.0","typeLabel":"object"},{"type":"null","additionalProperties":false,"required":["available","state","currency","startInclusive","endExclusive","resetAt","spent","pendingCommitted","used","remaining"],"properties":{"available":{"type":"boolean"},"state":{"type":"string","enum":["active","future","expired","inactive","unavailable"]},"currency":{"type":"string","enum":["USD"]},"startInclusive":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]},"endExclusive":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]},"resetAt":{"oneOf":[{"type":"string","format":"date-time"},{"type":"null","format":"date-time"}]},"spent":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable."},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable."}]},"pendingCommitted":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable."},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable."}]},"used":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable."},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable."}]},"remaining":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable."},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable."}]}},"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"additionalLimits.items.[INDEX].usage","typeLabel":"object | null"}},"uniqueKey":"additionalLimits.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"additionalLimits","typeLabel":"object[]"},"usage":{"type":"object","additionalProperties":false,"properties":{"purchaseLimit":{"oneOf":[{"type":"object","description":"Always null when this slot is present.","uniqueKey":"usage.purchaseLimit.oneOf.0","typeLabel":"object"},{"type":"null","description":"Always null when this slot is present.","uniqueKey":"usage.purchaseLimit.oneOf.1","typeLabel":"null"}],"uniqueKey":"usage.purchaseLimit","typeLabel":"object | null"},"recurringLimit":{"type":"object","additionalProperties":false,"required":["available","state","currency","startInclusive","endExclusive","resetAt","spent","pendingCommitted","used","remaining"],"properties":{"available":{"type":"boolean","isRequired":true,"uniqueKey":"usage.recurringLimit.available","typeLabel":"boolean"},"state":{"type":"string","enum":["active","future","expired","inactive","unavailable"],"isRequired":true,"uniqueKey":"usage.recurringLimit.state","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","enum":["USD"],"isRequired":true,"uniqueKey":"usage.recurringLimit.currency","typeLabel":"enum\u003cstring>"},"startInclusive":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"usage.recurringLimit.startInclusive.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"usage.recurringLimit.startInclusive.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.recurringLimit.startInclusive","typeLabel":"string\u003cdate-time> | null"},"endExclusive":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"usage.recurringLimit.endExclusive.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"usage.recurringLimit.endExclusive.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.recurringLimit.endExclusive","typeLabel":"string\u003cdate-time> | null"},"resetAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"usage.recurringLimit.resetAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"usage.recurringLimit.resetAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.recurringLimit.resetAt","typeLabel":"string\u003cdate-time> | null"},"spent":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.recurringLimit.spent.oneOf.0","typeLabel":"string"},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.recurringLimit.spent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.recurringLimit.spent","typeLabel":"string | null"},"pendingCommitted":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.recurringLimit.pendingCommitted.oneOf.0","typeLabel":"string"},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.recurringLimit.pendingCommitted.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.recurringLimit.pendingCommitted","typeLabel":"string | null"},"used":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.recurringLimit.used.oneOf.0","typeLabel":"string"},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.recurringLimit.used.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.recurringLimit.used","typeLabel":"string | null"},"remaining":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.recurringLimit.remaining.oneOf.0","typeLabel":"string"},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.recurringLimit.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.recurringLimit.remaining","typeLabel":"string | null"}},"uniqueKey":"usage.recurringLimit","typeLabel":"object"},"customLimit":{"type":"object","additionalProperties":false,"required":["available","state","currency","startInclusive","endExclusive","resetAt","spent","pendingCommitted","used","remaining"],"properties":{"available":{"type":"boolean","isRequired":true,"uniqueKey":"usage.customLimit.available","typeLabel":"boolean"},"state":{"type":"string","enum":["active","future","expired","inactive","unavailable"],"isRequired":true,"uniqueKey":"usage.customLimit.state","typeLabel":"enum\u003cstring>"},"currency":{"type":"string","enum":["USD"],"isRequired":true,"uniqueKey":"usage.customLimit.currency","typeLabel":"enum\u003cstring>"},"startInclusive":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"usage.customLimit.startInclusive.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"usage.customLimit.startInclusive.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.customLimit.startInclusive","typeLabel":"string\u003cdate-time> | null"},"endExclusive":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"usage.customLimit.endExclusive.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"usage.customLimit.endExclusive.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.customLimit.endExclusive","typeLabel":"string\u003cdate-time> | null"},"resetAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"usage.customLimit.resetAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"usage.customLimit.resetAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.customLimit.resetAt","typeLabel":"string\u003cdate-time> | null"},"spent":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.customLimit.spent.oneOf.0","typeLabel":"string"},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.customLimit.spent.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.customLimit.spent","typeLabel":"string | null"},"pendingCommitted":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.customLimit.pendingCommitted.oneOf.0","typeLabel":"string"},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.customLimit.pendingCommitted.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.customLimit.pendingCommitted","typeLabel":"string | null"},"used":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.customLimit.used.oneOf.0","typeLabel":"string"},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.customLimit.used.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.customLimit.used","typeLabel":"string | null"},"remaining":{"oneOf":[{"type":"string","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.customLimit.remaining.oneOf.0","typeLabel":"string"},{"type":"null","description":"Decimal USD amount, or null when evidence is unavailable.","isRequired":true,"uniqueKey":"usage.customLimit.remaining.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"usage.customLimit.remaining","typeLabel":"string | null"}},"uniqueKey":"usage.customLimit","typeLabel":"object"}},"isRequired":true,"uniqueKey":"usage","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"version":1073741823,"purchaseLimit":{"amount":"100.00","currency":"USD"},"recurringLimit":{"amount":"100.00","currency":"USD","period":"week"},"customLimit":{"amount":"100.00","currency":"USD","startDate":"2023-12-25","endDate":"2023-12-25"},"ruleId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","status":"active","evaluatedAt":"2023-11-07T05:31:56Z","configurationActive":true,"additionalLimits":[{"ruleId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","constraintId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","name":"\u003cstring>","scope":"match","limit":{"kind":"money","amount":"\u003cstring>","currency":"USD"},"groupBy":["agent"],"usage":{"available":true,"state":"active","currency":"USD","startInclusive":"2023-11-07T05:31:56Z","endExclusive":"2023-11-07T05:31:56Z","resetAt":"2023-11-07T05:31:56Z","spent":"\u003cstring>","pendingCommitted":"\u003cstring>","used":"\u003cstring>","remaining":"\u003cstring>"}}],"usage":{"purchaseLimit":{},"recurringLimit":{"available":true,"state":"active","currency":"USD","startInclusive":"2023-11-07T05:31:56Z","endExclusive":"2023-11-07T05:31:56Z","resetAt":"2023-11-07T05:31:56Z","spent":"\u003cstring>","pendingCommitted":"\u003cstring>","used":"\u003cstring>","remaining":"\u003cstring>"},"customLimit":{"available":true,"state":"active","currency":"USD","startInclusive":"2023-11-07T05:31:56Z","endExclusive":"2023-11-07T05:31:56Z","resetAt":"2023-11-07T05:31:56Z","spent":"\u003cstring>","pendingCommitted":"\u003cstring>","used":"\u003cstring>","remaining":"\u003cstring>"}}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e5c38066-a141-4b0d-adaa-71a7c9090353":{"api-key":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your platform key for buyer management, or a buyer key for everything else.","scopes":[],"schemeName":"api-key"}}},"servers":{"129d4bde-9564-498b-9b32-242ff84fee16":{"url":"https://api.sapiom.ai","description":"Production"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Your platform key for buyer management, or a buyer key for everything else.","scopes":[],"schemeName":"api-key"},"schema":{"title":"x-api-key","type":"string","description":"Your platform key for buyer management, or a buyer key for everything else.","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"api-key","name":"x-api-key"}],"title":"api-key"}]},"originalFileLocation":"api-reference/openapi.json"},"subdomain":"sapiom-1f975ca2","siteName":"Sapiom Pay","title":"Get spending limits - Sapiom Pay","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-24T01:29:35.462Z","originalFileLocation":"api-reference/spending-limits/get-spending-limits.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=\"Reads a card\u0026#x27;s spending limits, the saved version to send when you change them, and how much of each limit the card has used. Requires a key with org.read to read limits or org.write to set them, such as your platform key, and the buyer\u0026#x27;s ID in the sapiom-tenant header. Buyer keys have neither permission.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Sapiom Pay\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/sapiom-1f975ca2/YgmZC92WGBAfsBaa/_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/sapiom-1f975ca2/YgmZC92WGBAfsBaa/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/sapiom-1f975ca2/YgmZC92WGBAfsBaa/_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/sapiom-1f975ca2/YgmZC92WGBAfsBaa/_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/sapiom-1f975ca2/YgmZC92WGBAfsBaa/_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/sapiom-1f975ca2/YgmZC92WGBAfsBaa/_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/sapiom-1f975ca2/YgmZC92WGBAfsBaa/_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/sapiom-1f975ca2/YgmZC92WGBAfsBaa/_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/sapiom-1f975ca2/YgmZC92WGBAfsBaa/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get spending limits - Sapiom Pay\">\u003cmeta data-mint-head property=\"og:description\" content=\"Reads a card\u0026#x27;s spending limits, the saved version to send when you change them, and how much of each limit the card has used. Requires a key with org.read to read limits or org.write to set them, such as your platform key, and the buyer\u0026#x27;s ID in the sapiom-tenant header. Buyer keys have neither permission.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Sapiom Pay\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.sapiom.ai/api-reference/spending-limits/get-spending-limits\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://sapiom-1f975ca2.mintlify.app/_mintlify/api/og/v2?division=Spending+limits\u0026amp;title=Get+spending+limits\u0026amp;description=Reads+a+card%27s+spending+limits%2C+the+saved+%60version%60+to+send+when+you+change+them%2C+and+how+much+of+each+limit+the+card+has+used.+Requires+a+key+with+%60org.read%60+t\u0026amp;theme=094d3944263395c13d2c9b53\u0026amp;signature=817ce0ebdfbbf2dabc252f1922073ce2698411b236f00b028bc643802dbd1d5b\">\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 spending limits - Sapiom Pay\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Reads a card\u0026#x27;s spending limits, the saved version to send when you change them, and how much of each limit the card has used. Requires a key with org.read to read limits or org.write to set them, such as your platform key, and the buyer\u0026#x27;s ID in the sapiom-tenant header. Buyer keys have neither permission.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://sapiom-1f975ca2.mintlify.app/_mintlify/api/og/v2?division=Spending+limits\u0026amp;title=Get+spending+limits\u0026amp;description=Reads+a+card%27s+spending+limits%2C+the+saved+%60version%60+to+send+when+you+change+them%2C+and+how+much+of+each+limit+the+card+has+used.+Requires+a+key+with+%60org.read%60+t\u0026amp;theme=094d3944263395c13d2c9b53\u0026amp;signature=817ce0ebdfbbf2dabc252f1922073ce2698411b236f00b028bc643802dbd1d5b\">\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/sapiom-1f975ca2/YgmZC92WGBAfsBaa/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Sapiom Pay\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#16A34A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.sapiom.ai/api-reference/spending-limits/get-spending-limits\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/spending-limits/get-spending-limits.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.sapiom.ai/#organization\",\"name\":\"Sapiom Pay\",\"url\":\"https://docs.sapiom.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/sapiom-1f975ca2/K4zW5IjQAMJutZvi/logo/light.svg?fit=max\u0026auto=format\u0026n=K4zW5IjQAMJutZvi\u0026q=85\u0026s=37d04ab53c9792ff376364fd56a2799e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.sapiom.ai#website\",\"name\":\"Sapiom Pay\",\"url\":\"https://docs.sapiom.ai\",\"publisher\":{\"@id\":\"https://docs.sapiom.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.sapiom.ai/api-reference/spending-limits/get-spending-limits#webpage\",\"url\":\"https://docs.sapiom.ai/api-reference/spending-limits/get-spending-limits\",\"name\":\"Get spending limits\",\"description\":\"Reads a card's spending limits, the saved version to send when you change them, and how much of each limit the card has used. Requires a key with org.read to read limits or org.write to set them, such as your platform key, and the buyer's ID in the sapiom-tenant header. Buyer keys have neither permission.\",\"dateModified\":\"2026-10-24T01:29:35.462Z\",\"isPartOf\":{\"@id\":\"https://docs.sapiom.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.sapiom.ai/api-reference/spending-limits/get-spending-limits#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.sapiom.ai/api-reference/spending-limits/get-spending-limits#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"REST API\",\"item\":\"https://docs.sapiom.ai/api-reference/buyers/create-a-buyer\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get spending limits\",\"item\":\"https://docs.sapiom.ai/api-reference/spending-limits/get-spending-limits\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.sapiom.ai/api-reference/spending-limits/get-spending-limits#apireference\",\"headline\":\"Get spending limits\",\"name\":\"Get spending limits\",\"description\":\"Reads a card's spending limits, the saved version to send when you change them, and how much of each limit the card has used. Requires a key with org.read to read limits or org.write to set them, such as your platform key, and the buyer's ID in the sapiom-tenant header. Buyer keys have neither permission.\",\"url\":\"https://docs.sapiom.ai/api-reference/spending-limits/get-spending-limits\",\"mainEntityOfPage\":{\"@id\":\"https://docs.sapiom.ai/api-reference/spending-limits/get-spending-limits#webpage\"},\"dateModified\":\"2026-10-24T01:29:35.462Z\",\"publisher\":{\"@id\":\"https://docs.sapiom.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.sapiom.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Sapiom Pay\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Sapiom Pay","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":""}]},{"tab":"API reference","groups":[{"group":"Overview","pages":[{"title":"Sapiom Pay API overview","sidebarTitle":"Overview","href":"/api-reference/overview"}]},{"group":"REST API","pages":[{"group":"Buyers","pages":[{"title":"Create a buyer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/tenants","href":"/api-reference/buyers/create-a-buyer"},{"title":"List buyers","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/tenants","href":"/api-reference/buyers/list-buyers"},{"title":"Delete a buyer","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/tenants/{tenantId}","href":"/api-reference/buyers/delete-a-buyer"},{"title":"Create a buyer key","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/tenants/{tenantId}/api-keys","href":"/api-reference/buyers/create-a-buyer-key"}]},{"group":"Cards","pages":[{"title":"Create a setup link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/payment-cards/setup-links","href":"/api-reference/cards/create-a-setup-link"},{"title":"Get a setup link","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payment-cards/setup-links/{linkId}","href":"/api-reference/cards/get-a-setup-link"},{"title":"List cards","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payment-cards","href":"/api-reference/cards/list-cards"},{"title":"Get a card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payment-cards/{cardId}","href":"/api-reference/cards/get-a-card"},{"title":"Set the default card","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/payment-cards/{cardId}/default","href":"/api-reference/cards/set-the-default-card"},{"title":"Remove a card","description":"Remove a payment card. It can no longer pay from the moment this returns. Requires a [buyer key](/api-reference/overview#authentication).","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json delete /v1/payment-cards/{cardId}","href":"/api-reference/cards/remove-a-card"}]},{"group":"Spending limits","pages":[{"title":"Get spending limits","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/payment-cards/{cardId}/spending-limits","href":"/api-reference/spending-limits/get-spending-limits"},{"title":"Set spending limits","description":"Replaces a card's spending limits. Send the `version` from [Get spending limits](/api-reference/spending-limits/get-spending-limits), or `0` the first time, and `null` for any limit you don't want. Returns `409` when that version is out of date or the card can't be used. Requires a key with `org.read` to read limits or `org.write` to set them, such as your [platform key](/api-reference/overview#authentication), and the buyer's ID in the `sapiom-tenant` header. Buyer keys have neither permission.","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/payment-cards/{cardId}/spending-limits","href":"/api-reference/spending-limits/set-spending-limits"}]},{"group":"Merchants","pages":[{"title":"Check a merchant","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/transaction-compatibility","href":"/api-reference/merchants/check-a-merchant"}]},{"group":"Transactions","pages":[{"title":"Create a transaction","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/transactions","href":"/api-reference/transactions/create-a-transaction"},{"title":"Open the checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/transactions/{transactionId}/ucp/checkout","href":"/api-reference/transactions/open-the-checkout"},{"title":"Get the checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/transactions/{transactionId}/ucp/checkout","href":"/api-reference/transactions/get-the-checkout"},{"title":"Replace the checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json put /v1/transactions/{transactionId}/ucp/checkout","href":"/api-reference/transactions/replace-the-checkout"},{"title":"Cancel the checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/transactions/{transactionId}/ucp/checkout/cancel","href":"/api-reference/transactions/cancel-the-checkout"},{"title":"Refresh the checkout","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/transactions/{transactionId}/ucp/checkout/refresh","href":"/api-reference/transactions/refresh-the-checkout"}]},{"group":"Browser checkout","pages":[{"title":"List placeholder cards","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/card-placeholders","href":"/api-reference/browser-checkout/list-placeholder-cards"},{"title":"List relay profiles","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json get /v1/injection-profiles","href":"/api-reference/browser-checkout/list-relay-profiles"},{"title":"Relay a card request","deprecated":null,"version":null,"openapi":"/api-reference/openapi.json post /v1/transactions/{transactionId}/payment/relay","href":"/api-reference/browser-checkout/relay-a-card-request"}]}]},{"group":"MCP and SDK","pages":[{"title":"Sapiom Pay MCP tools reference","sidebarTitle":"MCP tools","href":"/api-reference/mcp-tools"},{"title":"Browser Pay SDK reference","sidebarTitle":"Browser Pay SDK","href":"/api-reference/browser-pay-sdk"}]},{"group":"Errors","pages":[{"title":"Sapiom Pay errors and how to handle them","sidebarTitle":"Errors","href":"/api-reference/errors"}]}]}]},"title":"Get spending limits - Sapiom Pay","buildId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","deploymentId":"dpl_HcHmUS6i3UwswnTHJUEdcTtwfdTQ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-BRm_l__d.js","utils-f1l1Oc-G.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BlhqDhJO.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-DHCB7rsC.js","snippetPresets-CYXLx6Hv.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-B78P2dEq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-C4YLPVAh.js","shallow-vlLnTDkQ.js","getApiPlaygroundDisplay-D_98hhvf.js","CodeSnippet-DtnZHGqq.js","CodeSnippets-CLFb8KJt.js","Page-kQh739Uz.js","getPastedJson-Cq-zlbnU.js","icon-sN3t983t.js","MethodPill-P_YQ2s09.js","DuplicateIcon-BVzyNsGJ.js","createIcon-B3jqgqC6.js","DynamicMarkdown-Crwq6WG_.js","SectionHeading-C7pGS2Bb.js","axios-vUo_bRtp.js","Markdown-BuPH8yuW.js","clsx-CCOYKgaU.js","lib--scc4DXi.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-BnkC_6oA.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BM4S31-f.js"]}