Creates a virtual card for an approved team member, with the funding plan, budget, spending limits and usage hours you choose. It returns 201 with the card when it’s ready (or with status: pending while it’s still being set up), or 202 if your business uses approvals and the request is waiting for an approver. Send an Idempotency-Key header so a retry of the same request within 24 hours returns the first result instead of creating another card; without one, repeated requests are not deduplicated, and a timeout or server error does not prove no card was created. See Idempotency for the limits, and see Issue cards to your team for the full flow. To limit the card to certain transaction categories, set them with Update card usage restriction after you create the card. See Cards.
Optional but recommended. Without it, Direct does not deduplicate repeated card-creation requests. A unique value you choose for each intended card, for example new-card-{userId}-2026-09-23; save it and reuse it only for retries of that card. Sending the same key again with the same body and API version within 24 hours returns the original result instead of creating a second card; reusing it with a different body returns IDEMPOTENCY_KEY_REUSED. If the first request failed with a timeout or an unexpected error on our side, the card may exist, so the same key returns IDEMPOTENCY_KEY_OUTCOME_UNKNOWN instead of trying again. An empty card list does not prove that no card was created: a new card may not be listed straight away, and a request waiting for approval is not listed until it is approved. Use a new key to repeat the creation only once you have confirmed the first request created neither a card nor a pending approval: check pending approvals in the dashboard and list your cards again after a few minutes. Empty lists alone do not confirm it, and neither does the key expiring after 24 hours; contact support with the requestId if you still cannot tell. See Idempotency for retention and recovery. Errors that mean no card was created, such as CARD_CREATION_BUSY and CARD_CREATION_UNAVAILABLE, release the key, so you can retry with the same key.
Body
application/json
type
enum<string>
required
The kind of card to create. Only virtual cards can be created through the API.
Available options:
virtual
title
string
required
A nickname for the card, up to 255 characters, shown in the dashboard and returned by the API. Say who or what the card is for, for example Ada – Marketing tools.
Maximum string length: 255
Pattern: \S
cardholderId
string
required
The userId of the team member who will hold the card, from List team members. The team member must have inviteStatusapproved, or the request fails with CARDHOLDER_NOT_FOUND.
category
string<uuid>
required
The ID of the card category, from List card categories, or the request fails with CARD_CATEGORY_NOT_FOUND. It labels what the card is for and doesn't limit where it can be used.
How the card is funded: subscription (the default) draws on your shared credit within the card's limits, and topUp gives the card its own fixed budget, set in spendCap.
Available options:
subscription,
topUp
isRevolving
boolean
Whether the card draws from your business's shared revolving budget. Leave it out or set it to false for top-up cards.
expiresAt
string<date> | null
The date you want the card to expire (YYYY-MM-DD). Leave it out to use the standard expiry date.
The fixed budget for a top-up card, for example 500.00 USD. It's required when planType is topUp, and the card declines card transactions once it's used up.
Show child attributes
spendControl
object
Spending limits to put on the card: per card transaction, or per day, week, month, year or lifetime. Set only the ones you need. No limit can be more than a limit for a longer period: for example, daily can't be more than monthly, and transaction can't be more than any period limit.
Show child attributes
restriction
object
The hours of the day when the card can be used, in UTC. Leave it out to allow use at any time.
Show child attributes
message
string | null
An optional note saved with the card request, up to 255 characters, for example to explain the request to an approver.
Maximum string length: 255
Response
Card created. You usually get the full card back; if it's still being set up, you get { id, status: pending } instead, and can fetch the URL in the Location header until the card is ready.
Where the card is in its lifecycle: pending (a physical card not yet activated), active (ready to use), frozen (paused, can be unfrozen), inactive (not usable for another reason, such as a restricted or blocked card), expiring (a physical card within 90 days of its expiry date), expired or terminated (permanently closed).
Available options:
pending,
active,
frozen,
inactive,
expiring,
expired,
terminated
title
string | null
required
The card's nickname, set when the card was created or renamed with Edit card details.
last4
string | null
required
The last four digits of the card number. To see the full card details, use Reveal card details.
Whether the card draws from your business's shared revolving budget. It's always false for top-up cards.
planType
enum<string> | null
required
How the card is funded: subscription (draws on shared credit within its limits), topUp (has its own fixed budget in spendCap) or physical (a physical card plan).
Available options:
physical,
subscription,
topUp,
null
category
string | null
required
The display name of the card category chosen when the card was created, for example Travel. It describes what the card is for and is different from each card transaction's category. To create a card with this category, pass its id from List card categories.
cardholder
object
required
The team member the card belongs to.
Show child attributes
spendCap
object | null
required
The fixed budget set aside for the card; for top-up cards, this is how much the card can spend in total. Change it with Update spend control. Null if the card has no fixed budget.
Show child attributes
spentAmount
object
required
How much has been spent on the card since it was created. For top-up cards, compare it with spendCap to see how much budget is left.
Show child attributes
spendControl
object
required
The card's spending limits, plus how much has been spent in each period so far.
Show child attributes
restriction
object
required
Rules on when and in which transaction categories the card can be used. Change them with Update card usage restriction.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Reap Business Account API","description":"The Reap Business Account API: manage cards, spend and Treasury funding for your Business Account from your own systems.","colors":{"primary":"#6D28D9","light":"#8B5CF6","dark":"#6D28D9"},"logo":{"light":"https://mintcdn.com/reap-95b0972c/U-qnAdIDeLDY01pU/logo/light.svg?fit=max\u0026auto=format\u0026n=U-qnAdIDeLDY01pU\u0026q=85\u0026s=1b3309048cb189a825d1de6904962f22","dark":"https://mintcdn.com/reap-95b0972c/U-qnAdIDeLDY01pU/logo/dark.svg?fit=max\u0026auto=format\u0026n=U-qnAdIDeLDY01pU\u0026q=85\u0026s=b663ea373f8210f8a5c80f12c4aaaf28"},"favicon":"https://mintcdn.com/reap-95b0972c/U-qnAdIDeLDY01pU/favicon.svg?fit=max\u0026auto=format\u0026n=U-qnAdIDeLDY01pU\u0026q=85\u0026s=5ded70531820ecffbe8f5359a9d0eeeb","api":{"playground":{"display":"interactive","proxy":false},"examples":{"languages":["bash","javascript","python"]}},"navbar":{"links":[{"href":"https://reap.global/contact-us","label":"Support"}],"primary":{"type":"button","label":"Open dashboard","href":"https://dashboard.reap.global"}},"footer":{"socials":{"website":"https://reap.global"}},"fonts":{"family":"Satoshi","weight":500,"source":"fonts/satoshi-variable.woff2","format":"woff2"},"styling":{"codeblocks":"system","latex":false},"contextual":{"options":["copy","view","cursor","claude"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"reap-95b0972c","hasAudioNarration":false,"actualSubdomain":"reap-95b0972c","customDomains":["direct-api.reap.global"],"gitSource":{"type":"github","owner":"reaphq","repo":"direct","deployBranch":"master","contentDirectory":"docs-site","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afac6573f5f5eede31cb7c3","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":90},{"language":"default","tag":"Cards","count":30},{"language":"default","tag":"Card account","count":21},{"language":"default","tag":"Documentation","count":17},{"language":"default","tag":"Treasury","count":12},{"language":"default","tag":"Concepts","count":10},{"language":"default","tag":"Setup","count":9},{"language":"default","tag":"Categories","count":6},{"language":"default","tag":"Files","count":6},{"language":"default","tag":"Getting started","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"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":"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":"site-roles","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},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":".sidebar-group-header,#sidebar-group-header{font-weight:700}a[href^=\"http\"]:not([href*=\"direct-api.reap.global\"])::after{content:'';display:inline-block;width:0.65em;height:0.65em;margin-left:0.2em;margin-right:0.05em;background-color:currentColor;-webkit-mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2.4' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M15 3h6v6'/%3E%3Cpath d='M10 14 21 3'/%3E%3Cpath d='M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6'/%3E%3C/svg%3E\")\n no-repeat center / contain;mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='2.4' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M15 3h6v6'/%3E%3Cpath d='M10 14 21 3'/%3E%3Cpath d='M18 13v6a2 2 0 0 1-2 2H5a2 2 0 0 1-2-2V8a2 2 0 0 1 2-2h6'/%3E%3C/svg%3E\")\n no-repeat center / contain}"}]}
{"page":{"pagePath":"api-reference/2026-11-05/cards/create-card","slug":"/api-reference/2026-11-05/cards/create-card","pageMetadata":{"title":"Create card","description":"Required API-key scope: `cards:write`.\n\nCreates a virtual card for an approved team member, with the funding plan, budget, spending limits and usage hours you choose. It returns `201` with the card when it's ready (or with `status: pending` while it's still being set up), or `202` if your business uses approvals and the request is waiting for an approver. Send an `Idempotency-Key` header so a retry of the same request within 24 hours returns the first result instead of creating another card; without one, repeated requests are not deduplicated, and a timeout or server error does not prove no card was created. See [Idempotency](/api-reference/idempotency) for the limits, and see [Issue cards to your team](/guides/issue-cards-to-your-team) for the full flow. To limit the card to certain transaction categories, set them with [Update card usage restriction](/api-reference/cards/update-card-usage-restriction) after you create the card. See [Cards](/concepts/cards).","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json post /2026-11-05/cards","href":"/api-reference/2026-11-05/cards/create-card","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n a: \"a\",\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsxs(_components.p, {\n children: [\"Required API-key scope: \", _jsx(_components.code, {\n children: \"cards:write\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"Creates a virtual card for an approved team member, with the funding plan, budget, spending limits and usage hours you choose. It returns \", _jsx(_components.code, {\n children: \"201\"\n }), \" with the card when it’s ready (or with \", _jsx(_components.code, {\n children: \"status: pending\"\n }), \" while it’s still being set up), or \", _jsx(_components.code, {\n children: \"202\"\n }), \" if your business uses approvals and the request is waiting for an approver. Send an \", _jsx(_components.code, {\n children: \"Idempotency-Key\"\n }), \" header so a retry of the same request within 24 hours returns the first result instead of creating another card; without one, repeated requests are not deduplicated, and a timeout or server error does not prove no card was created. See \", _jsx(_components.a, {\n href: \"/api-reference/idempotency\",\n children: \"Idempotency\"\n }), \" for the limits, and see \", _jsx(_components.a, {\n href: \"/guides/issue-cards-to-your-team\",\n children: \"Issue cards to your team\"\n }), \" for the full flow. To limit the card to certain transaction categories, set them with \", _jsx(_components.a, {\n href: \"/api-reference/cards/update-card-usage-restriction\",\n children: \"Update card usage restriction\"\n }), \" after you create the card. See \", _jsx(_components.a, {\n href: \"/concepts/cards\",\n children: \"Cards\"\n }), \".\"]\n })]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"codeStyling":"system","config":{},"pageMetadata":{"title":"Create card","description":"Required API-key scope: `cards:write`.\n\nCreates a virtual card for an approved team member, with the funding plan, budget, spending limits and usage hours you choose. It returns `201` with the card when it's ready (or with `status: pending` while it's still being set up), or `202` if your business uses approvals and the request is waiting for an approver. Send an `Idempotency-Key` header so a retry of the same request within 24 hours returns the first result instead of creating another card; without one, repeated requests are not deduplicated, and a timeout or server error does not prove no card was created. See [Idempotency](/api-reference/idempotency) for the limits, and see [Issue cards to your team](/guides/issue-cards-to-your-team) for the full flow. To limit the card to certain transaction categories, set them with [Update card usage restriction](/api-reference/cards/update-card-usage-restriction) after you create the card. See [Cards](/concepts/cards).","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json post /2026-11-05/cards","href":"/api-reference/2026-11-05/cards/create-card","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Required API-key scope: `cards:write`.\n\nCreates a virtual card for an approved team member, with the funding plan, budget, spending limits and usage hours you choose. It returns `201` with the card when it's ready (or with `status: pending` while it's still being set up), or `202` if your business uses approvals and the request is waiting for an approver. Send an `Idempotency-Key` header so a retry of the same request within 24 hours returns the first result instead of creating another card; without one, repeated requests are not deduplicated, and a timeout or server error does not prove no card was created. See [Idempotency](/api-reference/idempotency) for the limits, and see [Issue cards to your team](/guides/issue-cards-to-your-team) for the full flow. To limit the card to certain transaction categories, set them with [Update card usage restriction](/api-reference/cards/update-card-usage-restriction) after you create the card. See [Cards](/concepts/cards).","operationId":"createCard","parameters":["0eb9745c-752d-455f-9778-294734699d67"],"requestBody":"906f22fd-c34c-4e84-b8db-3d3e9a51ab14","responses":{"201":"5f2a56c0-27f0-41c7-b209-c1ed95ca88fe","202":"95e9ead8-2f7d-4615-998a-07316ac4fd9f","400":"29676a22-490a-4627-9142-88ffaf8d4b32","401":"5d909618-559d-4a4e-9831-7c9678ddd6a6","403":"0e9d7233-3226-4953-9b46-ee25c77a602a","409":"c51394e2-a397-4f0b-bb39-5d211e536c70","422":"11c690f0-e7ee-4bcd-abf8-be9308056198","429":"34b3fea2-95ef-4817-ae53-055c3314c131","500":"a9c0e476-d5b9-49d6-8c80-50e6eed08f52","503":"5efb6e37-9fff-4374-9e04-efcd18ff4cfb","504":"94b9fbb7-e047-49fa-8a14-14a2f9411310"},"security":["37b58378-6af9-4848-b951-c170cf21df47"],"summary":"Create card","tags":["Cards"],"method":"post","type":"path","servers":["00239ef3-6f5a-4929-84cb-a68e55473fcd"],"path":"/2026-11-05/cards","baseUrlOptions":["https://api.global.direct.reap.global"],"title":"Create card","codeSamples":[],"requestExampleLanguages":["bash","javascript","python"],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","disableProxy":true},"dependencies":{"parameters":{"0eb9745c-752d-455f-9778-294734699d67":{"name":"Idempotency-Key","in":"header","description":"Optional but recommended. Without it, Direct does not deduplicate repeated card-creation requests. A unique value you choose for each intended card, for example `new-card-{userId}-2026-09-23`; save it and reuse it only for retries of that card. Sending the same key again with the same body and API version within 24 hours returns the original result instead of creating a second card; reusing it with a different body returns `IDEMPOTENCY_KEY_REUSED`. If the first request failed with a timeout or an unexpected error on our side, the card may exist, so the same key returns `IDEMPOTENCY_KEY_OUTCOME_UNKNOWN` instead of trying again. An empty card list does not prove that no card was created: a new card may not be listed straight away, and a request waiting for approval is not listed until it is approved. Use a new key to repeat the creation only once you have confirmed the first request created neither a card nor a pending approval: check pending approvals in the dashboard and list your cards again after a few minutes. Empty lists alone do not confirm it, and neither does the key expiring after 24 hours; contact support with the `requestId` if you still cannot tell. See [Idempotency](/api-reference/idempotency) for retention and recovery. Errors that mean no card was created, such as `CARD_CREATION_BUSY` and `CARD_CREATION_UNAVAILABLE`, release the key, so you can retry with the same key.","required":false,"schema":{"type":"string","isRequired":false,"description":"Optional but recommended. Without it, Direct does not deduplicate repeated card-creation requests. A unique value you choose for each intended card, for example `new-card-{userId}-2026-09-23`; save it and reuse it only for retries of that card. Sending the same key again with the same body and API version within 24 hours returns the original result instead of creating a second card; reusing it with a different body returns `IDEMPOTENCY_KEY_REUSED`. If the first request failed with a timeout or an unexpected error on our side, the card may exist, so the same key returns `IDEMPOTENCY_KEY_OUTCOME_UNKNOWN` instead of trying again. An empty card list does not prove that no card was created: a new card may not be listed straight away, and a request waiting for approval is not listed until it is approved. Use a new key to repeat the creation only once you have confirmed the first request created neither a card nor a pending approval: check pending approvals in the dashboard and list your cards again after a few minutes. Empty lists alone do not confirm it, and neither does the key expiring after 24 hours; contact support with the `requestId` if you still cannot tell. See [Idempotency](/api-reference/idempotency) for retention and recovery. Errors that mean no card was created, such as `CARD_CREATION_BUSY` and `CARD_CREATION_UNAVAILABLE`, release the key, so you can retry with the same key.","uniqueKey":"","typeLabel":"string"}}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"type":{"type":"string","enum":["virtual"],"description":"The kind of card to create. Only `virtual` cards can be created through the API.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"title":{"type":"string","maxLength":255,"pattern":"\\S","description":"A nickname for the card, up to 255 characters, shown in the dashboard and returned by the API. Say who or what the card is for, for example `Ada – Marketing tools`.","isRequired":true,"uniqueKey":"title","typeLabel":"string"},"cardholderId":{"type":"string","description":"The `userId` of the team member who will hold the card, from [List team members](/api-reference/team-members/list-team-members). The team member must have `inviteStatus` `approved`, or the request fails with `CARDHOLDER_NOT_FOUND`.","isRequired":true,"uniqueKey":"cardholderId","typeLabel":"string"},"category":{"type":"string","format":"uuid","pattern":"^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12})$","description":"The ID of the card category, from [List card categories](/api-reference/cards/list-card-categories), or the request fails with `CARD_CATEGORY_NOT_FOUND`. It labels what the card is for and doesn't limit where it can be used.","isRequired":true,"uniqueKey":"category","typeLabel":"string\u003cuuid>"},"planType":{"type":"string","enum":["subscription","topUp"],"description":"How the card is funded: `subscription` (the default) draws on your shared credit within the card's limits, and `topUp` gives the card its own fixed budget, set in `spendCap`.","uniqueKey":"planType","typeLabel":"enum\u003cstring>"},"isRevolving":{"type":"boolean","description":"Whether the card draws from your business's shared revolving budget. Leave it out or set it to `false` for top-up cards.","uniqueKey":"isRevolving","typeLabel":"boolean"},"expiresAt":{"oneOf":[{"description":"The date you want the card to expire (`YYYY-MM-DD`). Leave it out to use the standard expiry date.","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","uniqueKey":"expiresAt.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"The date you want the card to expire (`YYYY-MM-DD`). Leave it out to use the standard expiry date.","type":"null","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","uniqueKey":"expiresAt.oneOf.1","typeLabel":"null"}],"uniqueKey":"expiresAt","typeLabel":"string\u003cdate> | null"},"spendCap":{"type":"object","properties":{"amount":{"type":"string","pattern":"^(?!0+(\\.0{1,2})?$)\\d{1,15}(\\.\\d{1,2})?$","description":"The amount as a string with up to two decimals, for example `500.00`. It must be greater than zero.","isRequired":true,"uniqueKey":"spendCap.amount","typeLabel":"string"},"currency":{"type":"string","enum":["USD","HKD"],"description":"The currency: `USD` or `HKD`. All amounts on a card must use the card's currency.","isRequired":true,"uniqueKey":"spendCap.currency","typeLabel":"enum\u003cstring>"}},"required":["amount","currency"],"description":"The fixed budget for a top-up card, for example `500.00` USD. It's required when `planType` is `topUp`, and the card declines card transactions once it's used up.","uniqueKey":"spendCap","typeLabel":"object"},"spendControl":{"type":"object","properties":{"transaction":{"type":"object","properties":{"amount":{"type":"string","pattern":"^(?!0+(\\.0{1,2})?$)\\d{1,9}(\\.\\d{1,2})?$","description":"The amount as a string with up to two decimals, for example `500.00`. It must be greater than zero and no more than `999999999.99`.","isRequired":true,"uniqueKey":"spendControl.transaction.amount","typeLabel":"string"},"currency":{"type":"string","enum":["USD","HKD"],"description":"The currency: `USD` or `HKD`. All amounts on a card must use the card's currency.","isRequired":true,"uniqueKey":"spendControl.transaction.currency","typeLabel":"enum\u003cstring>"}},"required":["amount","currency"],"description":"The most a single card transaction can be.","uniqueKey":"spendControl.transaction","typeLabel":"object"},"daily":{"type":"object","properties":{"amount":{"type":"string","pattern":"^(?!0+(\\.0{1,2})?$)\\d{1,9}(\\.\\d{1,2})?$","description":"The amount as a string with up to two decimals, for example `500.00`. It must be greater than zero and no more than `999999999.99`.","isRequired":true,"uniqueKey":"spendControl.daily.amount","typeLabel":"string"},"currency":{"type":"string","enum":["USD","HKD"],"description":"The currency: `USD` or `HKD`. All amounts on a card must use the card's currency.","isRequired":true,"uniqueKey":"spendControl.daily.currency","typeLabel":"enum\u003cstring>"}},"required":["amount","currency"],"description":"The most the card can spend in one day.","uniqueKey":"spendControl.daily","typeLabel":"object"},"weekly":{"type":"object","properties":{"amount":{"type":"string","pattern":"^(?!0+(\\.0{1,2})?$)\\d{1,9}(\\.\\d{1,2})?$","description":"The amount as a string with up to two decimals, for example `500.00`. It must be greater than zero and no more than `999999999.99`.","isRequired":true,"uniqueKey":"spendControl.weekly.amount","typeLabel":"string"},"currency":{"type":"string","enum":["USD","HKD"],"description":"The currency: `USD` or `HKD`. All amounts on a card must use the card's currency.","isRequired":true,"uniqueKey":"spendControl.weekly.currency","typeLabel":"enum\u003cstring>"}},"required":["amount","currency"],"description":"The most the card can spend in one week.","uniqueKey":"spendControl.weekly","typeLabel":"object"},"monthly":{"type":"object","properties":{"amount":{"type":"string","pattern":"^(?!0+(\\.0{1,2})?$)\\d{1,9}(\\.\\d{1,2})?$","description":"The amount as a string with up to two decimals, for example `500.00`. It must be greater than zero and no more than `999999999.99`.","isRequired":true,"uniqueKey":"spendControl.monthly.amount","typeLabel":"string"},"currency":{"type":"string","enum":["USD","HKD"],"description":"The currency: `USD` or `HKD`. All amounts on a card must use the card's currency.","isRequired":true,"uniqueKey":"spendControl.monthly.currency","typeLabel":"enum\u003cstring>"}},"required":["amount","currency"],"description":"The most the card can spend in one month.","uniqueKey":"spendControl.monthly","typeLabel":"object"},"yearly":{"type":"object","properties":{"amount":{"type":"string","pattern":"^(?!0+(\\.0{1,2})?$)\\d{1,9}(\\.\\d{1,2})?$","description":"The amount as a string with up to two decimals, for example `500.00`. It must be greater than zero and no more than `999999999.99`.","isRequired":true,"uniqueKey":"spendControl.yearly.amount","typeLabel":"string"},"currency":{"type":"string","enum":["USD","HKD"],"description":"The currency: `USD` or `HKD`. All amounts on a card must use the card's currency.","isRequired":true,"uniqueKey":"spendControl.yearly.currency","typeLabel":"enum\u003cstring>"}},"required":["amount","currency"],"description":"The most the card can spend in one year.","uniqueKey":"spendControl.yearly","typeLabel":"object"},"allTime":{"type":"object","properties":{"amount":{"type":"string","pattern":"^(?!0+(\\.0{1,2})?$)\\d{1,9}(\\.\\d{1,2})?$","description":"The amount as a string with up to two decimals, for example `500.00`. It must be greater than zero and no more than `999999999.99`.","isRequired":true,"uniqueKey":"spendControl.allTime.amount","typeLabel":"string"},"currency":{"type":"string","enum":["USD","HKD"],"description":"The currency: `USD` or `HKD`. All amounts on a card must use the card's currency.","isRequired":true,"uniqueKey":"spendControl.allTime.currency","typeLabel":"enum\u003cstring>"}},"required":["amount","currency"],"description":"The most the card can spend over its whole life.","uniqueKey":"spendControl.allTime","typeLabel":"object"}},"description":"Spending limits to put on the card: per card transaction, or per day, week, month, year or lifetime. Set only the ones you need. No limit can be more than a limit for a longer period: for example, `daily` can't be more than `monthly`, and `transaction` can't be more than any period limit.","uniqueKey":"spendControl","typeLabel":"object"},"restriction":{"type":"object","properties":{"time":{"oneOf":[{"description":"The window of hours each day when the card can be used, in UTC. Null or left out means the card can be used at any time.","type":"object","properties":{"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","description":"When the window opens each day, in UTC (`HH:mm`, from `00:00` to `23:59`), for example `09:00`.","isRequired":true,"uniqueKey":"restriction.time.oneOf.0.start","typeLabel":"string"},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","description":"When the window closes each day, in UTC (`HH:mm`, from `00:00` to `23:59`), for example `18:00`. It must differ from `start`. An `end` earlier than `start` makes the window run past midnight, so `22:00` to `06:00` allows use overnight.","isRequired":true,"uniqueKey":"restriction.time.oneOf.0.end","typeLabel":"string"}},"required":["start","end"],"uniqueKey":"restriction.time.oneOf.0","typeLabel":"object"},{"description":"The window of hours each day when the card can be used, in UTC. Null or left out means the card can be used at any time.","type":"null","properties":{"start":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","description":"When the window opens each day, in UTC (`HH:mm`, from `00:00` to `23:59`), for example `09:00`."},"end":{"type":"string","pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","description":"When the window closes each day, in UTC (`HH:mm`, from `00:00` to `23:59`), for example `18:00`. It must differ from `start`. An `end` earlier than `start` makes the window run past midnight, so `22:00` to `06:00` allows use overnight."}},"required":["start","end"],"uniqueKey":"restriction.time.oneOf.1","typeLabel":"null"}],"uniqueKey":"restriction.time","typeLabel":"object | null"}},"description":"The hours of the day when the card can be used, in UTC. Leave it out to allow use at any time.","uniqueKey":"restriction","typeLabel":"object"},"message":{"oneOf":[{"description":"An optional note saved with the card request, up to 255 characters, for example to explain the request to an approver.","type":"string","maxLength":255,"uniqueKey":"message.oneOf.0","typeLabel":"string"},{"description":"An optional note saved with the card request, up to 255 characters, for example to explain the request to an approver.","type":"null","maxLength":255,"uniqueKey":"message.oneOf.1","typeLabel":"null"}],"uniqueKey":"message","typeLabel":"string | null"}},"required":["type","title","cardholderId","category"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"type":"virtual","title":"\u003cstring>","cardholderId":"\u003cstring>","category":"3c90c3cc-0d44-4b50-8888-8dd25736052a","isRevolving":true,"expiresAt":"2023-12-25","spendControl":{},"restriction":{"time":{"start":"\u003cstring>","end":"\u003cstring>"}},"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"5f2a56c0-27f0-41c7-b209-c1ed95ca88fe":{"description":"Card created. You usually get the full card back; if it's still being set up, you get `{ id, status: pending }` instead, and can fetch the URL in the `Location` header until the card is ready.","headers":{"Location":{"description":"The URL of the new card on this API version. Call it to fetch the card, for example while its status is `pending`.","schema":{"type":"string"}}},"content":{"application/json":{"schema":{"oneOf":[{"type":"object","required":["id","type","status","title","last4","expiresAt","isRevolving","planType","category","cardholder","spendCap","spentAmount","spendControl","restriction","createdAt","updatedAt"],"properties":{"id":{"type":"string","description":"The card's unique ID. Use it with [Retrieve a card](/api-reference/cards/retrieve-a-card), [Freeze card](/api-reference/cards/freeze-card) and the other card endpoints.","isRequired":true,"uniqueKey":"oneOf.0.id","typeLabel":"string"},"type":{"type":"string","enum":["virtual","physical"],"description":"Whether this is a `virtual` or a `physical` card.","isRequired":true,"uniqueKey":"oneOf.0.type","typeLabel":"enum\u003cstring>"},"status":{"type":"string","enum":["pending","active","frozen","inactive","expiring","expired","terminated"],"description":"Where the card is in its lifecycle: `pending` (a physical card not yet activated), `active` (ready to use), `frozen` (paused, can be unfrozen), `inactive` (not usable for another reason, such as a restricted or blocked card), `expiring` (a physical card within 90 days of its expiry date), `expired` or `terminated` (permanently closed).","isRequired":true,"uniqueKey":"oneOf.0.status","typeLabel":"enum\u003cstring>"},"title":{"oneOf":[{"description":"The card's nickname, set when the card was created or renamed with [Edit card details](/api-reference/cards/edit-card-details).","type":"string","isRequired":true,"uniqueKey":"oneOf.0.title.oneOf.0","typeLabel":"string"},{"description":"The card's nickname, set when the card was created or renamed with [Edit card details](/api-reference/cards/edit-card-details).","type":"null","isRequired":true,"uniqueKey":"oneOf.0.title.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.title","typeLabel":"string | null"},"last4":{"oneOf":[{"description":"The last four digits of the card number. To see the full card details, use [Reveal card details](/api-reference/cards/reveal-card-details).","type":"string","isRequired":true,"uniqueKey":"oneOf.0.last4.oneOf.0","typeLabel":"string"},{"description":"The last four digits of the card number. To see the full card details, use [Reveal card details](/api-reference/cards/reveal-card-details).","type":"null","isRequired":true,"uniqueKey":"oneOf.0.last4.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.last4","typeLabel":"string | null"},"expiresAt":{"oneOf":[{"description":"The date the card expires (`YYYY-MM-DD`).","type":"string","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","isRequired":true,"uniqueKey":"oneOf.0.expiresAt.oneOf.0","typeLabel":"string\u003cdate>"},{"description":"The date the card expires (`YYYY-MM-DD`).","type":"null","format":"date","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$","isRequired":true,"uniqueKey":"oneOf.0.expiresAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.expiresAt","typeLabel":"string\u003cdate> | null"},"isRevolving":{"type":"boolean","description":"Whether the card draws from your business's shared revolving budget. It's always `false` for top-up cards.","isRequired":true,"uniqueKey":"oneOf.0.isRevolving","typeLabel":"boolean"},"planType":{"oneOf":[{"description":"How the card is funded: `subscription` (draws on shared credit within its limits), `topUp` (has its own fixed budget in `spendCap`) or `physical` (a physical card plan).","type":"string","enum":["physical","subscription","topUp",null],"isRequired":true,"uniqueKey":"oneOf.0.planType.oneOf.0","typeLabel":"enum\u003cstring>"},{"description":"How the card is funded: `subscription` (draws on shared credit within its limits), `topUp` (has its own fixed budget in `spendCap`) or `physical` (a physical card plan).","type":"null","enum":["physical","subscription","topUp",null],"isRequired":true,"uniqueKey":"oneOf.0.planType.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.planType","typeLabel":"enum\u003cstring> | null"},"category":{"oneOf":[{"description":"The display name of the card category chosen when the card was created, for example `Travel`. It describes what the card is for and is different from each card transaction's category. To create a card with this category, pass its `id` from [List card categories](/api-reference/cards/list-card-categories).","type":"string","isRequired":true,"uniqueKey":"oneOf.0.category.oneOf.0","typeLabel":"string"},{"description":"The display name of the card category chosen when the card was created, for example `Travel`. It describes what the card is for and is different from each card transaction's category. To create a card with this category, pass its `id` from [List card categories](/api-reference/cards/list-card-categories).","type":"null","isRequired":true,"uniqueKey":"oneOf.0.category.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.category","typeLabel":"string | null"},"cardholder":{"type":"object","properties":{"userId":{"oneOf":[{"description":"The team member's ID, the same as in [List team members](/api-reference/team-members/list-team-members).","type":"string","isRequired":true,"uniqueKey":"oneOf.0.cardholder.userId.oneOf.0","typeLabel":"string"},{"description":"The team member's ID, the same as in [List team members](/api-reference/team-members/list-team-members).","type":"null","isRequired":true,"uniqueKey":"oneOf.0.cardholder.userId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.cardholder.userId","typeLabel":"string | null"},"name":{"oneOf":[{"description":"The team member's full name.","type":"string","isRequired":true,"uniqueKey":"oneOf.0.cardholder.name.oneOf.0","typeLabel":"string"},{"description":"The team member's full name.","type":"null","isRequired":true,"uniqueKey":"oneOf.0.cardholder.name.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.cardholder.name","typeLabel":"string | null"},"email":{"oneOf":[{"description":"The team member's email address.","type":"string","isRequired":true,"uniqueKey":"oneOf.0.cardholder.email.oneOf.0","typeLabel":"string"},{"description":"The team member's email address.","type":"null","isRequired":true,"uniqueKey":"oneOf.0.cardholder.email.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.cardholder.email","typeLabel":"string | null"}},"required":["userId","name","email"],"description":"The team member the card belongs to.","isRequired":true,"uniqueKey":"oneOf.0.cardholder","typeLabel":"object"},"spendCap":{"oneOf":[{"description":"The fixed budget set aside for the card; for top-up cards, this is how much the card can spend in total. Change it with [Update spend control](/api-reference/cards/update-spend-control). Null if the card has no fixed budget.","type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendCap.oneOf.0.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendCap.oneOf.0.currency","typeLabel":"string"}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"oneOf.0.spendCap.oneOf.0","typeLabel":"object"},{"description":"The fixed budget set aside for the card; for top-up cards, this is how much the card can spend in total. Change it with [Update spend control](/api-reference/cards/update-spend-control). Null if the card has no fixed budget.","type":"null","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`."},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`."}},"required":["amount","currency"],"isRequired":true,"uniqueKey":"oneOf.0.spendCap.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.spendCap","typeLabel":"object | null"},"spentAmount":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spentAmount.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spentAmount.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"How much has been spent on the card since it was created. For top-up cards, compare it with `spendCap` to see how much budget is left.","isRequired":true,"uniqueKey":"oneOf.0.spentAmount","typeLabel":"object"},"spendControl":{"type":"object","properties":{"limits":{"type":"object","properties":{"transaction":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.limits.transaction.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.limits.transaction.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"The most a single card transaction can be.","uniqueKey":"oneOf.0.spendControl.limits.transaction","typeLabel":"object"},"daily":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.limits.daily.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.limits.daily.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"The most the card can spend in one day.","uniqueKey":"oneOf.0.spendControl.limits.daily","typeLabel":"object"},"weekly":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.limits.weekly.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.limits.weekly.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"The most the card can spend in one week.","uniqueKey":"oneOf.0.spendControl.limits.weekly","typeLabel":"object"},"monthly":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.limits.monthly.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.limits.monthly.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"The most the card can spend in one month.","uniqueKey":"oneOf.0.spendControl.limits.monthly","typeLabel":"object"},"yearly":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.limits.yearly.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.limits.yearly.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"The most the card can spend in one year.","uniqueKey":"oneOf.0.spendControl.limits.yearly","typeLabel":"object"},"allTime":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.limits.allTime.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.limits.allTime.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"The most the card can spend over its whole life.","uniqueKey":"oneOf.0.spendControl.limits.allTime","typeLabel":"object"}},"description":"The spending limits set on the card. Only the limits that have been set are returned.","uniqueKey":"oneOf.0.spendControl.limits","typeLabel":"object"},"spent":{"type":"object","properties":{"daily":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.spent.daily.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.spent.daily.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"Spent so far today.","uniqueKey":"oneOf.0.spendControl.spent.daily","typeLabel":"object"},"weekly":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.spent.weekly.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.spent.weekly.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"Spent so far this week.","uniqueKey":"oneOf.0.spendControl.spent.weekly","typeLabel":"object"},"monthly":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.spent.monthly.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.spent.monthly.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"Spent so far this month.","uniqueKey":"oneOf.0.spendControl.spent.monthly","typeLabel":"object"},"yearly":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.spent.yearly.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.spent.yearly.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"Spent so far this year.","uniqueKey":"oneOf.0.spendControl.spent.yearly","typeLabel":"object"},"allTime":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.spent.allTime.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.spent.allTime.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"Spent since the card was created.","uniqueKey":"oneOf.0.spendControl.spent.allTime","typeLabel":"object"}},"description":"How much the card has spent so far in each period that has a limit. Compare it with `limits` to see how much room is left.","uniqueKey":"oneOf.0.spendControl.spent","typeLabel":"object"},"atm":{"type":"object","properties":{"dailyWithdrawal":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.atm.dailyWithdrawal.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.atm.dailyWithdrawal.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"The most cash that can be withdrawn in one day.","uniqueKey":"oneOf.0.spendControl.atm.dailyWithdrawal","typeLabel":"object"},"monthlyWithdrawal":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.atm.monthlyWithdrawal.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.atm.monthlyWithdrawal.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"The most cash that can be withdrawn in one month.","uniqueKey":"oneOf.0.spendControl.atm.monthlyWithdrawal","typeLabel":"object"},"yearlyWithdrawal":{"type":"object","properties":{"amount":{"type":"string","description":"The amount as a string with two decimals, for example `100.00`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.atm.yearlyWithdrawal.amount","typeLabel":"string"},"currency":{"type":"string","description":"The three-letter currency code, for example `USD`.","isRequired":true,"uniqueKey":"oneOf.0.spendControl.atm.yearlyWithdrawal.currency","typeLabel":"string"}},"required":["amount","currency"],"description":"The most cash that can be withdrawn in one year.","uniqueKey":"oneOf.0.spendControl.atm.yearlyWithdrawal","typeLabel":"object"},"dailyFrequency":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The maximum number of ATM withdrawals per day.","uniqueKey":"oneOf.0.spendControl.atm.dailyFrequency","typeLabel":"integer"},"monthlyFrequency":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The maximum number of ATM withdrawals per month.","uniqueKey":"oneOf.0.spendControl.atm.monthlyFrequency","typeLabel":"integer"},"yearlyFrequency":{"type":"integer","minimum":-9007199254740991,"maximum":9007199254740991,"description":"The maximum number of ATM withdrawals per year.","uniqueKey":"oneOf.0.spendControl.atm.yearlyFrequency","typeLabel":"integer"}},"description":"Limits on cash withdrawals at ATMs, which apply to physical cards.","uniqueKey":"oneOf.0.spendControl.atm","typeLabel":"object"}},"description":"The card's spending limits, plus how much has been spent in each period so far.","isRequired":true,"uniqueKey":"oneOf.0.spendControl","typeLabel":"object"},"restriction":{"type":"object","properties":{"time":{"oneOf":[{"description":"The window of hours each day when the card can be used, in UTC. Null means the card can be used at any time.","type":"object","properties":{"start":{"oneOf":[{"description":"When the window opens each day, in UTC (`HH:mm`), for example `09:00`.","type":"string","isRequired":true,"uniqueKey":"oneOf.0.restriction.time.oneOf.0.start.oneOf.0","typeLabel":"string"},{"description":"When the window opens each day, in UTC (`HH:mm`), for example `09:00`.","type":"null","isRequired":true,"uniqueKey":"oneOf.0.restriction.time.oneOf.0.start.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.restriction.time.oneOf.0.start","typeLabel":"string | null"},"end":{"oneOf":[{"description":"When the window closes each day, in UTC (`HH:mm`), for example `18:00`.","type":"string","isRequired":true,"uniqueKey":"oneOf.0.restriction.time.oneOf.0.end.oneOf.0","typeLabel":"string"},{"description":"When the window closes each day, in UTC (`HH:mm`), for example `18:00`.","type":"null","isRequired":true,"uniqueKey":"oneOf.0.restriction.time.oneOf.0.end.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"oneOf.0.restriction.time.oneOf.0.end","typeLabel":"string | null"}},"required":["start","end"],"uniqueKey":"oneOf.0.restriction.time.oneOf.0","typeLabel":"object"},{"description":"The window of hours each day when the card can be used, in UTC. Null means the card can be used at any time.","type":"null","properties":{"start":{"oneOf":[{"description":"When the window opens each day, in UTC (`HH:mm`), for example `09:00`.","type":"string"},{"description":"When the window opens each day, in UTC (`HH:mm`), for example `09:00`.","type":"null"}]},"end":{"oneOf":[{"description":"When the window closes each day, in UTC (`HH:mm`), for example `18:00`.","type":"string"},{"description":"When the window closes each day, in UTC (`HH:mm`), for example `18:00`.","type":"null"}]}},"required":["start","end"],"uniqueKey":"oneOf.0.restriction.time.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.restriction.time","typeLabel":"object | null"},"category":{"oneOf":[{"description":"The transaction categories the card is limited to. Null means the card has no category restriction.","type":"object","properties":{"allow":{"type":"boolean","description":"When `true`, the card can only be used in the categories in `values`. When `false`, the card can be used in every category except those in `values`. Cards you set through this API always have `true`.","isRequired":true,"uniqueKey":"oneOf.0.restriction.category.oneOf.0.allow","typeLabel":"boolean"},"values":{"type":"array","items":{"type":"string","uniqueKey":"oneOf.0.restriction.category.oneOf.0.values.items.[INDEX]","typeLabel":"string"},"description":"The category codes of the restriction, for example `flights`. The codes you can set are `software_and_saas`, `cloud_and_infrastructure`, `advertising_and_marketing`, `conferences_and_events`, `flights`, `lodging_and_hotels`, `rideshare_and_taxis`, `ground_and_other_travel`, `meals_and_entertainment`, `computers_and_electronic_devices`, `office_supplies_and_furniture`, `utilities`, `telecom`, `shipping_and_logistics`, `professional_services`, `legal`, `accounting_and_tax`, `insurance`, `banking_and_financial_fees`, `education_and_training`, `subscriptions_and_memberships`, `general_merchandise`.","isRequired":true,"uniqueKey":"oneOf.0.restriction.category.oneOf.0.values","typeLabel":"string[]"}},"required":["allow","values"],"uniqueKey":"oneOf.0.restriction.category.oneOf.0","typeLabel":"object"},{"description":"The transaction categories the card is limited to. Null means the card has no category restriction.","type":"null","properties":{"allow":{"type":"boolean","description":"When `true`, the card can only be used in the categories in `values`. When `false`, the card can be used in every category except those in `values`. Cards you set through this API always have `true`."},"values":{"type":"array","items":{"type":"string"},"description":"The category codes of the restriction, for example `flights`. The codes you can set are `software_and_saas`, `cloud_and_infrastructure`, `advertising_and_marketing`, `conferences_and_events`, `flights`, `lodging_and_hotels`, `rideshare_and_taxis`, `ground_and_other_travel`, `meals_and_entertainment`, `computers_and_electronic_devices`, `office_supplies_and_furniture`, `utilities`, `telecom`, `shipping_and_logistics`, `professional_services`, `legal`, `accounting_and_tax`, `insurance`, `banking_and_financial_fees`, `education_and_training`, `subscriptions_and_memberships`, `general_merchandise`."}},"required":["allow","values"],"uniqueKey":"oneOf.0.restriction.category.oneOf.1","typeLabel":"null"}],"uniqueKey":"oneOf.0.restriction.category","typeLabel":"object | null"}},"description":"Rules on when and in which transaction categories the card can be used. Change them with [Update card usage restriction](/api-reference/cards/update-card-usage-restriction).","isRequired":true,"uniqueKey":"oneOf.0.restriction","typeLabel":"object"},"createdAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"When the card was created, in UTC.","isRequired":true,"uniqueKey":"oneOf.0.createdAt","typeLabel":"string\u003cdate-time>"},"updatedAt":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z))$","description":"When the card's details, limits or status last changed, in UTC.","isRequired":true,"uniqueKey":"oneOf.0.updatedAt","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"oneOf.0","typeLabel":"object"},{"type":"object","required":["id","status"],"properties":{"id":{"type":"string","description":"The new card's ID. Save it, then call [Retrieve a card](/api-reference/cards/retrieve-a-card) or the `Location` URL until the card is ready.","isRequired":true,"uniqueKey":"oneOf.1.id","typeLabel":"string"},"status":{"type":"string","enum":["pending"],"description":"Always `pending`: the card has been created, but its details aren't available yet.","isRequired":true,"uniqueKey":"oneOf.1.status","typeLabel":"enum\u003cstring>"}},"uniqueKey":"oneOf.1","typeLabel":"object"}],"uniqueKey":"","typeLabel":"object"},"examples":{"created":{"title":"created","summary":"Card created","value":{"id":"3db05d6f-97a9-4c06-a578-087b14b4f859","type":"virtual","status":"active","title":"Travel card","last4":"4242","expiresAt":"2028-08-31","isRevolving":false,"planType":"topUp","category":"Travel","cardholder":{"userId":"user_01JZ2Q1J4Y8P7M6N5K3H2G1F0E","name":"Ada Lovelace","email":"ada@example.com"},"spendCap":{"amount":"5000.00","currency":"USD"},"spentAmount":{"amount":"0.00","currency":"USD"},"spendControl":{"limits":{"transaction":{"amount":"1000.00","currency":"USD"},"monthly":{"amount":"5000.00","currency":"USD"}},"spent":{"monthly":{"amount":"0.00","currency":"USD"}},"atm":{"dailyWithdrawal":{"amount":"500.00","currency":"USD"},"dailyFrequency":3}},"restriction":{"time":{"start":"09:00","end":"18:00"},"category":{"allow":true,"values":["flights"]}},"createdAt":"2026-07-13T08:00:00.000Z","updatedAt":"2026-07-13T08:00:00.000Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"95e9ead8-2f7d-4615-998a-07316ac4fd9f":{"description":"Your business uses approvals, so the card request is waiting for an approver in the Business Account dashboard. No card exists yet.","content":{"application/json":{"schema":{"type":"object","properties":{"approvalRequestId":{"type":"string","description":"The ID of the approval request. Once an approver accepts it in the dashboard, the card appears in [List cards](/api-reference/cards/list-cards).","isRequired":true,"uniqueKey":"approvalRequestId","typeLabel":"string"},"status":{"type":"string","enum":["pendingApproval"],"description":"Always `pendingApproval`: the card hasn't been created yet and is waiting for an approver.","isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"}},"required":["approvalRequestId","status"],"uniqueKey":"","typeLabel":"object"},"examples":{"pendingApproval":{"title":"pendingApproval","summary":"Card creation awaiting approval","value":{"approvalRequestId":"approval_01JZ2Q8A6B4C3D2E1F0G9H8J7K","status":"pendingApproval"}}},"exampleType":"examples"}},"exampleType":"examples"},"29676a22-490a-4627-9142-88ffaf8d4b32":{"description":"`BAD_REQUEST`","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","minimum":100,"maximum":599,"description":"The HTTP status code, repeated in the body for convenience.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"type":{"type":"string","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","RATE_LIMIT_ERROR","API_ERROR","UPSTREAM_ERROR"],"description":"The broad kind of error, for example `RATE_LIMIT_ERROR`. It's always present: use it to decide whether to retry, re-authenticate or fix the request.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A plain-English explanation of the error that's safe to show to your users.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"A stable, machine-readable error code, for example `CARD_CREATION_REQUIRES_DEPOSIT`. It's present when there's a specific action you can take, and each endpoint lists the codes it can return.","type":"string","uniqueKey":"code","typeLabel":"string"},"param":{"description":"The request field that caused a validation error, for example `spendCap`.","type":"string","uniqueKey":"param","typeLabel":"string"},"details":{"description":"Extra structured information, such as the list of validation issues or the API-key scopes your key is missing.","uniqueKey":"details","typeLabel":"any"},"requestId":{"description":"A unique ID for this request. Include it when you contact Reap Support so the team can find it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["statusCode","type","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"BAD_REQUEST":{"title":"BAD_REQUEST","summary":"BAD_REQUEST","value":{"statusCode":400,"type":"INVALID_REQUEST_ERROR","message":"Bad request."}}},"exampleType":"examples"}},"exampleType":"examples"},"5d909618-559d-4a4e-9831-7c9678ddd6a6":{"description":"`UNAUTHORIZED`, `AUTH_CREDENTIAL_MISSING`, `API_KEY_INVALID`","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","minimum":100,"maximum":599,"description":"The HTTP status code, repeated in the body for convenience.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"type":{"type":"string","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","RATE_LIMIT_ERROR","API_ERROR","UPSTREAM_ERROR"],"description":"The broad kind of error, for example `RATE_LIMIT_ERROR`. It's always present: use it to decide whether to retry, re-authenticate or fix the request.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A plain-English explanation of the error that's safe to show to your users.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"A stable, machine-readable error code, for example `CARD_CREATION_REQUIRES_DEPOSIT`. It's present when there's a specific action you can take, and each endpoint lists the codes it can return.","type":"string","uniqueKey":"code","typeLabel":"string"},"param":{"description":"The request field that caused a validation error, for example `spendCap`.","type":"string","uniqueKey":"param","typeLabel":"string"},"details":{"description":"Extra structured information, such as the list of validation issues or the API-key scopes your key is missing.","uniqueKey":"details","typeLabel":"any"},"requestId":{"description":"A unique ID for this request. Include it when you contact Reap Support so the team can find it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["statusCode","type","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"UNAUTHORIZED":{"title":"UNAUTHORIZED","summary":"UNAUTHORIZED","value":{"statusCode":401,"type":"AUTHENTICATION_ERROR","message":"Authentication required."}},"AUTH_CREDENTIAL_MISSING":{"title":"AUTH_CREDENTIAL_MISSING","summary":"AUTH_CREDENTIAL_MISSING","value":{"statusCode":401,"type":"AUTHENTICATION_ERROR","code":"AUTH_CREDENTIAL_MISSING","message":"Authentication is required."}},"API_KEY_INVALID":{"title":"API_KEY_INVALID","summary":"API_KEY_INVALID","value":{"statusCode":401,"type":"AUTHENTICATION_ERROR","code":"API_KEY_INVALID","message":"API key is invalid."}}},"exampleType":"examples"}},"exampleType":"examples"},"0e9d7233-3226-4953-9b46-ee25c77a602a":{"description":"`FORBIDDEN`, `API_KEY_IP_NOT_ALLOWED`, `AUTH_INSUFFICIENT_PERMISSIONS`, `AUTH_METHOD_NOT_ALLOWED`","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","minimum":100,"maximum":599,"description":"The HTTP status code, repeated in the body for convenience.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"type":{"type":"string","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","RATE_LIMIT_ERROR","API_ERROR","UPSTREAM_ERROR"],"description":"The broad kind of error, for example `RATE_LIMIT_ERROR`. It's always present: use it to decide whether to retry, re-authenticate or fix the request.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A plain-English explanation of the error that's safe to show to your users.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"A stable, machine-readable error code, for example `CARD_CREATION_REQUIRES_DEPOSIT`. It's present when there's a specific action you can take, and each endpoint lists the codes it can return.","type":"string","uniqueKey":"code","typeLabel":"string"},"param":{"description":"The request field that caused a validation error, for example `spendCap`.","type":"string","uniqueKey":"param","typeLabel":"string"},"details":{"description":"Extra structured information, such as the list of validation issues or the API-key scopes your key is missing.","uniqueKey":"details","typeLabel":"any"},"requestId":{"description":"A unique ID for this request. Include it when you contact Reap Support so the team can find it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["statusCode","type","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"FORBIDDEN":{"title":"FORBIDDEN","summary":"FORBIDDEN","value":{"statusCode":403,"type":"PERMISSION_ERROR","message":"You do not have permission to perform this action."}},"API_KEY_IP_NOT_ALLOWED":{"title":"API_KEY_IP_NOT_ALLOWED","summary":"API_KEY_IP_NOT_ALLOWED","value":{"statusCode":403,"type":"PERMISSION_ERROR","code":"API_KEY_IP_NOT_ALLOWED","message":"Request IP is not allowed for this API key."}},"AUTH_INSUFFICIENT_PERMISSIONS":{"title":"AUTH_INSUFFICIENT_PERMISSIONS","summary":"AUTH_INSUFFICIENT_PERMISSIONS","value":{"statusCode":403,"type":"PERMISSION_ERROR","code":"AUTH_INSUFFICIENT_PERMISSIONS","message":"Insufficient permissions.","details":{"requiredScopes":["\u003crequired-scope>"]}}},"AUTH_METHOD_NOT_ALLOWED":{"title":"AUTH_METHOD_NOT_ALLOWED","summary":"AUTH_METHOD_NOT_ALLOWED","value":{"statusCode":403,"type":"PERMISSION_ERROR","code":"AUTH_METHOD_NOT_ALLOWED","message":"This endpoint does not accept the credential type provided."}}},"exampleType":"examples"}},"exampleType":"examples"},"c51394e2-a397-4f0b-bb39-5d211e536c70":{"description":"`IDEMPOTENCY_KEY_IN_FLIGHT`, `IDEMPOTENCY_KEY_OUTCOME_UNKNOWN`","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","minimum":100,"maximum":599,"description":"The HTTP status code, repeated in the body for convenience.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"type":{"type":"string","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","RATE_LIMIT_ERROR","API_ERROR","UPSTREAM_ERROR"],"description":"The broad kind of error, for example `RATE_LIMIT_ERROR`. It's always present: use it to decide whether to retry, re-authenticate or fix the request.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A plain-English explanation of the error that's safe to show to your users.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"A stable, machine-readable error code, for example `CARD_CREATION_REQUIRES_DEPOSIT`. It's present when there's a specific action you can take, and each endpoint lists the codes it can return.","type":"string","uniqueKey":"code","typeLabel":"string"},"param":{"description":"The request field that caused a validation error, for example `spendCap`.","type":"string","uniqueKey":"param","typeLabel":"string"},"details":{"description":"Extra structured information, such as the list of validation issues or the API-key scopes your key is missing.","uniqueKey":"details","typeLabel":"any"},"requestId":{"description":"A unique ID for this request. Include it when you contact Reap Support so the team can find it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["statusCode","type","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"IDEMPOTENCY_KEY_IN_FLIGHT":{"title":"IDEMPOTENCY_KEY_IN_FLIGHT","summary":"IDEMPOTENCY_KEY_IN_FLIGHT","value":{"statusCode":409,"type":"INVALID_REQUEST_ERROR","code":"IDEMPOTENCY_KEY_IN_FLIGHT","message":"A request with this Idempotency-Key is still being processed. Retry shortly."}},"IDEMPOTENCY_KEY_OUTCOME_UNKNOWN":{"title":"IDEMPOTENCY_KEY_OUTCOME_UNKNOWN","summary":"IDEMPOTENCY_KEY_OUTCOME_UNKNOWN","value":{"statusCode":409,"type":"INVALID_REQUEST_ERROR","code":"IDEMPOTENCY_KEY_OUTCOME_UNKNOWN","message":"The first request with this Idempotency-Key may have completed. Check its outcome before you retry with a new Idempotency-Key."}}},"exampleType":"examples"}},"exampleType":"examples"},"11c690f0-e7ee-4bcd-abf8-be9308056198":{"description":"`CARD_CREATION_REQUIRES_DEPOSIT`, `CARDHOLDER_NOT_FOUND`, `CARD_CATEGORY_NOT_FOUND`, `IDEMPOTENCY_KEY_REUSED`, `CURRENCY_MISMATCH`","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","minimum":100,"maximum":599,"description":"The HTTP status code, repeated in the body for convenience.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"type":{"type":"string","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","RATE_LIMIT_ERROR","API_ERROR","UPSTREAM_ERROR"],"description":"The broad kind of error, for example `RATE_LIMIT_ERROR`. It's always present: use it to decide whether to retry, re-authenticate or fix the request.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A plain-English explanation of the error that's safe to show to your users.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"A stable, machine-readable error code, for example `CARD_CREATION_REQUIRES_DEPOSIT`. It's present when there's a specific action you can take, and each endpoint lists the codes it can return.","type":"string","uniqueKey":"code","typeLabel":"string"},"param":{"description":"The request field that caused a validation error, for example `spendCap`.","type":"string","uniqueKey":"param","typeLabel":"string"},"details":{"description":"Extra structured information, such as the list of validation issues or the API-key scopes your key is missing.","uniqueKey":"details","typeLabel":"any"},"requestId":{"description":"A unique ID for this request. Include it when you contact Reap Support so the team can find it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["statusCode","type","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"CARD_CREATION_REQUIRES_DEPOSIT":{"title":"CARD_CREATION_REQUIRES_DEPOSIT","summary":"CARD_CREATION_REQUIRES_DEPOSIT","value":{"statusCode":422,"type":"INVALID_REQUEST_ERROR","code":"CARD_CREATION_REQUIRES_DEPOSIT","message":"Deposit funds before creating a card."}},"CARDHOLDER_NOT_FOUND":{"title":"CARDHOLDER_NOT_FOUND","summary":"CARDHOLDER_NOT_FOUND","value":{"statusCode":422,"type":"INVALID_REQUEST_ERROR","code":"CARDHOLDER_NOT_FOUND","message":"No team member matches the provided cardholder id."}},"CARD_CATEGORY_NOT_FOUND":{"title":"CARD_CATEGORY_NOT_FOUND","summary":"CARD_CATEGORY_NOT_FOUND","value":{"statusCode":422,"type":"INVALID_REQUEST_ERROR","code":"CARD_CATEGORY_NOT_FOUND","message":"No card category matches the provided category id."}},"IDEMPOTENCY_KEY_REUSED":{"title":"IDEMPOTENCY_KEY_REUSED","summary":"IDEMPOTENCY_KEY_REUSED","value":{"statusCode":422,"type":"INVALID_REQUEST_ERROR","code":"IDEMPOTENCY_KEY_REUSED","message":"This Idempotency-Key was already used with a different request body."}},"CURRENCY_MISMATCH":{"title":"CURRENCY_MISMATCH","summary":"CURRENCY_MISMATCH","value":{"statusCode":422,"type":"INVALID_REQUEST_ERROR","code":"CURRENCY_MISMATCH","message":"The provided currency does not match the card currency."}}},"exampleType":"examples"}},"exampleType":"examples"},"34b3fea2-95ef-4817-ae53-055c3314c131":{"description":"`CARD_LIMIT_EXCEEDED`, `CARD_CREATION_BUSY`","headers":{"Retry-After":{"description":"Sent with `CARD_CREATION_BUSY`: the number of seconds to wait before retrying.","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","minimum":100,"maximum":599,"description":"The HTTP status code, repeated in the body for convenience.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"type":{"type":"string","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","RATE_LIMIT_ERROR","API_ERROR","UPSTREAM_ERROR"],"description":"The broad kind of error, for example `RATE_LIMIT_ERROR`. It's always present: use it to decide whether to retry, re-authenticate or fix the request.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A plain-English explanation of the error that's safe to show to your users.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"A stable, machine-readable error code, for example `CARD_CREATION_REQUIRES_DEPOSIT`. It's present when there's a specific action you can take, and each endpoint lists the codes it can return.","type":"string","uniqueKey":"code","typeLabel":"string"},"param":{"description":"The request field that caused a validation error, for example `spendCap`.","type":"string","uniqueKey":"param","typeLabel":"string"},"details":{"description":"Extra structured information, such as the list of validation issues or the API-key scopes your key is missing.","uniqueKey":"details","typeLabel":"any"},"requestId":{"description":"A unique ID for this request. Include it when you contact Reap Support so the team can find it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["statusCode","type","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"API_KEY_RATE_LIMITED":{"title":"API_KEY_RATE_LIMITED","summary":"API_KEY_RATE_LIMITED","value":{"statusCode":429,"type":"RATE_LIMIT_ERROR","code":"API_KEY_RATE_LIMITED","message":"API key rate limit exceeded."}},"CARD_LIMIT_EXCEEDED":{"title":"CARD_LIMIT_EXCEEDED","summary":"CARD_LIMIT_EXCEEDED","value":{"statusCode":429,"type":"RATE_LIMIT_ERROR","code":"CARD_LIMIT_EXCEEDED","message":"Your account has reached the maximum number of cards. Contact support to request more."}},"CARD_CREATION_BUSY":{"title":"CARD_CREATION_BUSY","summary":"CARD_CREATION_BUSY","value":{"statusCode":429,"type":"RATE_LIMIT_ERROR","code":"CARD_CREATION_BUSY","message":"Another card is being created for this business. Retry after a few seconds."}}},"exampleType":"examples"}},"exampleType":"examples"},"a9c0e476-d5b9-49d6-8c80-50e6eed08f52":{"description":"`INTERNAL_ERROR`","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","minimum":100,"maximum":599,"description":"The HTTP status code, repeated in the body for convenience.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"type":{"type":"string","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","RATE_LIMIT_ERROR","API_ERROR","UPSTREAM_ERROR"],"description":"The broad kind of error, for example `RATE_LIMIT_ERROR`. It's always present: use it to decide whether to retry, re-authenticate or fix the request.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A plain-English explanation of the error that's safe to show to your users.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"A stable, machine-readable error code, for example `CARD_CREATION_REQUIRES_DEPOSIT`. It's present when there's a specific action you can take, and each endpoint lists the codes it can return.","type":"string","uniqueKey":"code","typeLabel":"string"},"param":{"description":"The request field that caused a validation error, for example `spendCap`.","type":"string","uniqueKey":"param","typeLabel":"string"},"details":{"description":"Extra structured information, such as the list of validation issues or the API-key scopes your key is missing.","uniqueKey":"details","typeLabel":"any"},"requestId":{"description":"A unique ID for this request. Include it when you contact Reap Support so the team can find it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["statusCode","type","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"INTERNAL_ERROR":{"title":"INTERNAL_ERROR","summary":"INTERNAL_ERROR","value":{"statusCode":500,"type":"API_ERROR","message":"An unexpected error occurred."}}},"exampleType":"examples"}},"exampleType":"examples"},"5efb6e37-9fff-4374-9e04-efcd18ff4cfb":{"description":"`CARD_CREATION_UNAVAILABLE`, `IDEMPOTENCY_UNAVAILABLE`","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","minimum":100,"maximum":599,"description":"The HTTP status code, repeated in the body for convenience.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"type":{"type":"string","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","RATE_LIMIT_ERROR","API_ERROR","UPSTREAM_ERROR"],"description":"The broad kind of error, for example `RATE_LIMIT_ERROR`. It's always present: use it to decide whether to retry, re-authenticate or fix the request.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A plain-English explanation of the error that's safe to show to your users.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"A stable, machine-readable error code, for example `CARD_CREATION_REQUIRES_DEPOSIT`. It's present when there's a specific action you can take, and each endpoint lists the codes it can return.","type":"string","uniqueKey":"code","typeLabel":"string"},"param":{"description":"The request field that caused a validation error, for example `spendCap`.","type":"string","uniqueKey":"param","typeLabel":"string"},"details":{"description":"Extra structured information, such as the list of validation issues or the API-key scopes your key is missing.","uniqueKey":"details","typeLabel":"any"},"requestId":{"description":"A unique ID for this request. Include it when you contact Reap Support so the team can find it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["statusCode","type","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"CARD_CREATION_UNAVAILABLE":{"title":"CARD_CREATION_UNAVAILABLE","summary":"CARD_CREATION_UNAVAILABLE","value":{"statusCode":503,"type":"API_ERROR","code":"CARD_CREATION_UNAVAILABLE","message":"Card creation temporarily unavailable. Please retry shortly."}},"IDEMPOTENCY_UNAVAILABLE":{"title":"IDEMPOTENCY_UNAVAILABLE","summary":"IDEMPOTENCY_UNAVAILABLE","value":{"statusCode":503,"type":"API_ERROR","code":"IDEMPOTENCY_UNAVAILABLE","message":"The idempotent request outcome could not be safely determined."}}},"exampleType":"examples"}},"exampleType":"examples"},"94b9fbb7-e047-49fa-8a14-14a2f9411310":{"description":"`UPSTREAM_TIMEOUT`","content":{"application/json":{"schema":{"type":"object","properties":{"statusCode":{"type":"integer","minimum":100,"maximum":599,"description":"The HTTP status code, repeated in the body for convenience.","isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"type":{"type":"string","enum":["INVALID_REQUEST_ERROR","AUTHENTICATION_ERROR","PERMISSION_ERROR","RATE_LIMIT_ERROR","API_ERROR","UPSTREAM_ERROR"],"description":"The broad kind of error, for example `RATE_LIMIT_ERROR`. It's always present: use it to decide whether to retry, re-authenticate or fix the request.","isRequired":true,"uniqueKey":"type","typeLabel":"enum\u003cstring>"},"message":{"type":"string","description":"A plain-English explanation of the error that's safe to show to your users.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"code":{"description":"A stable, machine-readable error code, for example `CARD_CREATION_REQUIRES_DEPOSIT`. It's present when there's a specific action you can take, and each endpoint lists the codes it can return.","type":"string","uniqueKey":"code","typeLabel":"string"},"param":{"description":"The request field that caused a validation error, for example `spendCap`.","type":"string","uniqueKey":"param","typeLabel":"string"},"details":{"description":"Extra structured information, such as the list of validation issues or the API-key scopes your key is missing.","uniqueKey":"details","typeLabel":"any"},"requestId":{"description":"A unique ID for this request. Include it when you contact Reap Support so the team can find it.","type":"string","uniqueKey":"requestId","typeLabel":"string"}},"required":["statusCode","type","message"],"uniqueKey":"","typeLabel":"object"},"examples":{"UPSTREAM_TIMEOUT":{"title":"UPSTREAM_TIMEOUT","summary":"UPSTREAM_TIMEOUT","value":{"statusCode":504,"type":"UPSTREAM_ERROR","code":"UPSTREAM_TIMEOUT","message":"An upstream service did not respond in time. If this request changes data, it may still have been applied, so fetch the resource before you retry."}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"37b58378-6af9-4848-b951-c170cf21df47":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Enter your API key","scopes":[],"schemeName":"apiKey"}}},"servers":{"00239ef3-6f5a-4929-84cb-a68e55473fcd":{"url":"https://api.global.direct.reap.global"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Enter your API key","scopes":[],"schemeName":"apiKey"},"schema":{"title":"x-api-key","type":"string","description":"Enter your API key","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apiKey","name":"x-api-key"}],"title":"apiKey"}]},"originalFileLocation":"openapi/2026-11-05.json"},"subdomain":"reap-95b0972c","siteName":"Reap Business Account API","title":"Create card - Reap Business Account API","navMaps":{"firstHrefInVersion":{"2026-11-16":{"href":"/api-reference/cards/create-card-2026-11-16","matchLevel":2},"2026-11-05":{"href":"/api-reference/2026-11-05/cards/create-card","matchLevel":0},"2026-07-13":{"href":"/api-reference/cards/create-card","matchLevel":2}},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T09:01:22.164Z","originalFileLocation":"api-reference/2026-11-05/cards/create-card.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=\"Required API-key scope: cards:write. Creates a virtual card for an approved team member, with the funding plan, budget, spending limits and usage hours you choose. It returns 201 with the card when it\u0026#x27;s ready (or with status: pending while it\u0026#x27;s still being set up), or 202 if your business uses approvals and the request is waiting for an approver. Send an Idempotency-Key header so a retry of the same request within 24 hours returns the first result instead of creating another card; without one, repeated requests are not deduplicated, and a timeout or server error does not prove no card was created. See Idempotency for the limits, and see Issue cards to your team for the full flow. To limit the card to certain transaction categories, set them with Update card usage restriction after you create the card. See Cards.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Reap Business Account 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/reap-95b0972c/ALiTyxFaoge0C610/_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/reap-95b0972c/ALiTyxFaoge0C610/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/reap-95b0972c/ALiTyxFaoge0C610/_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/reap-95b0972c/ALiTyxFaoge0C610/_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/reap-95b0972c/ALiTyxFaoge0C610/_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/reap-95b0972c/ALiTyxFaoge0C610/_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/reap-95b0972c/ALiTyxFaoge0C610/_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/reap-95b0972c/ALiTyxFaoge0C610/_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/reap-95b0972c/ALiTyxFaoge0C610/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Create card - Reap Business Account API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Required API-key scope: cards:write. Creates a virtual card for an approved team member, with the funding plan, budget, spending limits and usage hours you choose. It returns 201 with the card when it\u0026#x27;s ready (or with status: pending while it\u0026#x27;s still being set up), or 202 if your business uses approvals and the request is waiting for an approver. Send an Idempotency-Key header so a retry of the same request within 24 hours returns the first result instead of creating another card; without one, repeated requests are not deduplicated, and a timeout or server error does not prove no card was created. See Idempotency for the limits, and see Issue cards to your team for the full flow. To limit the card to certain transaction categories, set them with Update card usage restriction after you create the card. See Cards.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Reap Business Account API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://direct-api.reap.global/api-reference/2026-11-05/cards/create-card\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://reap-95b0972c.mintlify.site/_mintlify/api/og/v2?division=Cards\u0026amp;title=Create+card\u0026amp;description=Required+API-key+scope%3A+%60cards%3Awrite%60.%0A%0ACreates+a+virtual+card+for+an+approved+team+member%2C+with+the+funding+plan%2C+budget%2C+spending+limits+and+usage+hours+you+c\u0026amp;theme=605bd2972b54409c21f7942f\u0026amp;signature=5eb2364d7d992bb4e209b4aff308daae533fb9326a4f04038ea5e817e9a8c7e9\">\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=\"Create card - Reap Business Account API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Required API-key scope: cards:write. Creates a virtual card for an approved team member, with the funding plan, budget, spending limits and usage hours you choose. It returns 201 with the card when it\u0026#x27;s ready (or with status: pending while it\u0026#x27;s still being set up), or 202 if your business uses approvals and the request is waiting for an approver. Send an Idempotency-Key header so a retry of the same request within 24 hours returns the first result instead of creating another card; without one, repeated requests are not deduplicated, and a timeout or server error does not prove no card was created. See Idempotency for the limits, and see Issue cards to your team for the full flow. To limit the card to certain transaction categories, set them with Update card usage restriction after you create the card. See Cards.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://reap-95b0972c.mintlify.site/_mintlify/api/og/v2?division=Cards\u0026amp;title=Create+card\u0026amp;description=Required+API-key+scope%3A+%60cards%3Awrite%60.%0A%0ACreates+a+virtual+card+for+an+approved+team+member%2C+with+the+funding+plan%2C+budget%2C+spending+limits+and+usage+hours+you+c\u0026amp;theme=605bd2972b54409c21f7942f\u0026amp;signature=5eb2364d7d992bb4e209b4aff308daae533fb9326a4f04038ea5e817e9a8c7e9\">\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/reap-95b0972c/ALiTyxFaoge0C610/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Reap Business Account API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6D28D9\">\u003clink data-mint-head rel=\"canonical\" href=\"https://direct-api.reap.global/api-reference/2026-11-05/cards/create-card\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/2026-11-05/cards/create-card.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://direct-api.reap.global/#organization\",\"name\":\"Reap Business Account API\",\"url\":\"https://direct-api.reap.global\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/reap-95b0972c/U-qnAdIDeLDY01pU/logo/light.svg?fit=max\u0026auto=format\u0026n=U-qnAdIDeLDY01pU\u0026q=85\u0026s=1b3309048cb189a825d1de6904962f22\"}},{\"@type\":\"WebSite\",\"@id\":\"https://direct-api.reap.global#website\",\"name\":\"Reap Business Account API\",\"url\":\"https://direct-api.reap.global\",\"publisher\":{\"@id\":\"https://direct-api.reap.global/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://direct-api.reap.global/api-reference/2026-11-05/cards/create-card#webpage\",\"url\":\"https://direct-api.reap.global/api-reference/2026-11-05/cards/create-card\",\"name\":\"Create card\",\"description\":\"Required API-key scope: cards:write. Creates a virtual card for an approved team member, with the funding plan, budget, spending limits and usage hours you choose. It returns 201 with the card when it's ready (or with status: pending while it's still being set up), or 202 if your business uses approvals and the request is waiting for an approver. Send an Idempotency-Key header so a retry of the same request within 24 hours returns the first result instead of creating another card; without one, repeated requests are not deduplicated, and a timeout or server error does not prove no card was created. See Idempotency for the limits, and see Issue cards to your team for the full flow. To limit the card to certain transaction categories, set them with Update card usage restriction after you create the card. See Cards.\",\"dateModified\":\"2026-11-16T09:01:22.164Z\",\"isPartOf\":{\"@id\":\"https://direct-api.reap.global#website\"},\"breadcrumb\":{\"@id\":\"https://direct-api.reap.global/api-reference/2026-11-05/cards/create-card#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://direct-api.reap.global/api-reference/2026-11-05/cards/create-card#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reap Business Account API\",\"item\":\"https://direct-api.reap.global\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Create card\",\"item\":\"https://direct-api.reap.global/api-reference/2026-11-05/cards/create-card\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://direct-api.reap.global/api-reference/2026-11-05/cards/create-card#apireference\",\"headline\":\"Create card\",\"name\":\"Create card\",\"description\":\"Required API-key scope: cards:write. Creates a virtual card for an approved team member, with the funding plan, budget, spending limits and usage hours you choose. It returns 201 with the card when it's ready (or with status: pending while it's still being set up), or 202 if your business uses approvals and the request is waiting for an approver. Send an Idempotency-Key header so a retry of the same request within 24 hours returns the first result instead of creating another card; without one, repeated requests are not deduplicated, and a timeout or server error does not prove no card was created. See Idempotency for the limits, and see Issue cards to your team for the full flow. To limit the card to certain transaction categories, set them with Update card usage restriction after you create the card. See Cards.\",\"url\":\"https://direct-api.reap.global/api-reference/2026-11-05/cards/create-card\",\"mainEntityOfPage\":{\"@id\":\"https://direct-api.reap.global/api-reference/2026-11-05/cards/create-card#webpage\"},\"dateModified\":\"2026-11-16T09:01:22.164Z\",\"publisher\":{\"@id\":\"https://direct-api.reap.global/#organization\"},\"isPartOf\":{\"@id\":\"https://direct-api.reap.global#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Reap Business Account API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Reap Business Account API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/2026-11-05/cards/create-card.md","siteName":"Reap Business Account API","nav":{"global":null,"versions":[{"version":"2026-11-16","default":true,"pages":[{"title":"2026-11-16","href":"/api-reference/cards/create-card-2026-11-16"}]},{"version":"2026-11-05","tabs":[{"tab":"Documentation","pages":[{"title":"Documentation","href":""}]},{"tab":"API Reference","groups":[{"group":"Setup","pages":[{"title":"Overview","href":"/api-reference/overview"},{"title":"Authentication","href":"/api-reference/authentication"},{"title":"Versioning","href":"/api-reference/versioning"},{"title":"Errors","href":"/api-reference/errors"},{"title":"Pagination","href":"/api-reference/pagination"},{"title":"Idempotency","href":"/api-reference/idempotency"},{"title":"Rate limits","href":"/api-reference/rate-limits"},{"title":"Error code catalog","href":"/api-reference/error-codes"},{"title":"Polling and waiting","description":"Every poll cadence and stop condition in the Business Account API, collected in one place.","href":"/api-reference/polling"}]},{"group":"Cards","pages":[{"title":"Create card","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json post /2026-11-05/cards","href":"/api-reference/2026-11-05/cards/create-card"},{"title":"List cards","description":"Required API-key scope: `cards:read`.\n\nReturns the cards on your Business Account, with each card's status, cardholder, budget, spending limits and how much it has spent. Use it to show a card list in your own tools, find a card by cardholder, nickname or last four digits, or check which cards are close to their limits. To get a single card, use [Retrieve a card](/api-reference/cards/retrieve-a-card). See [Cards](/concepts/cards).","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/cards","href":"/api-reference/2026-11-05/cards/list-cards"},{"title":"Retrieve a card","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/cards/{cardId}","href":"/api-reference/2026-11-05/cards/retrieve-a-card"},{"title":"Edit card details","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json put /2026-11-05/cards/{cardId}","href":"/api-reference/2026-11-05/cards/edit-card-details"},{"title":"Update spend control","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json put /2026-11-05/cards/{cardId}/spend-control","href":"/api-reference/2026-11-05/cards/update-spend-control"},{"title":"Update card usage restriction","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json put /2026-11-05/cards/{cardId}/restriction","href":"/api-reference/2026-11-05/cards/update-card-usage-restriction"},{"title":"Reveal card details","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json post /2026-11-05/cards/{cardId}/reveal","href":"/api-reference/2026-11-05/cards/reveal-card-details"},{"title":"Freeze card","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json put /2026-11-05/cards/{cardId}/freeze","href":"/api-reference/2026-11-05/cards/freeze-card"},{"title":"Unfreeze card","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json put /2026-11-05/cards/{cardId}/unfreeze","href":"/api-reference/2026-11-05/cards/unfreeze-card"},{"title":"Terminate card","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json delete /2026-11-05/cards/{cardId}","href":"/api-reference/2026-11-05/cards/terminate-card"}]},{"group":"Card account","pages":[{"title":"Retrieve card-account balances","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/cards/balances","href":"/api-reference/2026-11-05/cards/retrieve-card-account-balances"},{"title":"List card account activities","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/cards/activities","href":"/api-reference/2026-11-05/cards/list-card-account-activities"},{"title":"Update card account activity","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json patch /2026-11-05/cards/activities/{activityId}","href":"/api-reference/2026-11-05/cards/update-card-account-activity"},{"title":"List receipts on a card account activity","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/cards/activities/{activityId}/receipts","href":"/api-reference/2026-11-05/cards/list-receipts-on-a-card-account-activity"},{"title":"Attach a receipt to a card account activity","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json post /2026-11-05/cards/activities/{activityId}/receipts","href":"/api-reference/2026-11-05/cards/attach-a-receipt-to-a-card-account-activity"},{"title":"Retrieve a receipt on a card account activity","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/cards/activities/{activityId}/receipts/{receiptId}","href":"/api-reference/2026-11-05/cards/retrieve-a-receipt-on-a-card-account-activity"},{"title":"Delete a receipt on a card account activity","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json delete /2026-11-05/cards/activities/{activityId}/receipts/{receiptId}","href":"/api-reference/2026-11-05/cards/delete-a-receipt-on-a-card-account-activity"}]},{"group":"Categories","pages":[{"title":"List card categories","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/cards/categories","href":"/api-reference/2026-11-05/cards/list-card-categories"},{"title":"List transaction categories","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/cards/transaction-categories","href":"/api-reference/2026-11-05/cards/list-transaction-categories"}]},{"group":"Team members","pages":[{"title":"List team members","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/team-members","href":"/api-reference/2026-11-05/team-members/list-team-members"}]},{"group":"Treasury","pages":[{"title":"List Treasury funding options","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/treasury/funding-options","href":"/api-reference/2026-11-05/treasury/list-treasury-funding-options"},{"title":"Get Treasury funding instructions","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/treasury/funding-instructions","href":"/api-reference/2026-11-05/treasury/get-treasury-funding-instructions"},{"title":"Confirm a bank transfer","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json post /2026-11-05/treasury/bank-transfer-confirmations","href":"/api-reference/2026-11-05/treasury/confirm-a-bank-transfer"},{"title":"List Treasury transactions","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/treasury/transactions","href":"/api-reference/2026-11-05/treasury/list-treasury-transactions"}]},{"group":"Files","pages":[{"title":"Upload a file","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json post /2026-11-05/files","href":"/api-reference/2026-11-05/files/upload-a-file"},{"title":"Retrieve a file","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/files/{fileId}","href":"/api-reference/2026-11-05/files/retrieve-a-file"}]},{"group":"Health","pages":[{"title":"Check API health","deprecated":null,"version":null,"openapi":"/openapi/2026-11-05.json get /2026-11-05/health","href":"/api-reference/2026-11-05/health/check-api-health"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},{"version":"2026-07-13","pages":[{"title":"2026-07-13","href":"/api-reference/cards/create-card"}]}]},"basePath":"","title":"Create card - Reap Business Account API","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js","Markdown-CX2QY19L.js","AssistantPageLink-CY3bFglh.js","dist-Dl6_zDnT.js","lib-DMeTj1gb.js","lib-B8HbPgcC.js","katex-Dbtb6Wk7.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js"]}