# Reap Business Account API > The Reap Business Account API: manage cards, spend and Treasury funding for your Business Account from your own systems. - [Introduction](https://direct-api.reap.global/index.md): Manage cards, spend and Treasury funding for your Business Account from your own systems. - [Quickstart](https://direct-api.reap.global/quickstart.md): Go from a new API key to your first card in a few calls: check the key, find a cardholder, create a card, reveal it, then clean up. - [Get access and API keys](https://direct-api.reap.global/getting-started/access-and-api-keys.md): Who can request Business Account API access, how API keys are created, and the rules for scopes, IP allowlists and key lifecycle. - [Use the MCP server](https://direct-api.reap.global/getting-started/mcp-server.md): Connect Claude Code or Codex to your Business Account with an API key, choose when the assistant asks before it acts, and approve card changes safely. - [Issue cards to your team from your own system](https://direct-api.reap.global/guides/issue-cards-to-your-team.md): Create virtual cards for team members, reveal card details securely, and track spend and balances, all from your own tools. - [Issue cards for advertising campaigns at scale](https://direct-api.reap.global/guides/issue-cards-for-advertising.md): Create a dedicated virtual card for every ad account or campaign, give each one a fixed budget, limit it to advertising charges, and manage them all from your own system. - [Retrieve funding instructions and Treasury history](https://direct-api.reap.global/guides/retrieve-funding-instructions-and-treasury-history.md): Get the wallet address or bank details that make up the funding information for your account, confirm bank transfers, and follow every movement in and out of your Treasury from your own tools. - [Team members](https://direct-api.reap.global/concepts/team-members.md): Team members are the people on your Business Account. The API reads them so you can choose who holds a card. - [Cards](https://direct-api.reap.global/concepts/cards.md): Virtual cards belong to team members and carry a funding plan, a budget and spending limits. Every status and creation outcome explained. - [Spend controls](https://direct-api.reap.global/concepts/spend-controls.md): spendCap is a top-up card's total budget; spendControl limits throttle spending per transaction and per period; restriction limits the hours and merchant categories a card can be used in. Each is a full replacement. - [Approvals](https://direct-api.reap.global/concepts/approvals.md): If your business uses Approvals, cards created through the API wait for an approver in the dashboard before they're issued. - [Card details](https://direct-api.reap.global/concepts/card-details.md): The reveal endpoint returns a short-lived link to a Reap-hosted view of the card number, expiry and CVV, so card data never touches your servers. - [Card account balances](https://direct-api.reap.global/concepts/card-account.md): The card account is your business's shared credit pool. Balances explains the six figures that describe how much credit is in use. - [Card activities](https://direct-api.reap.global/concepts/activities.md): Card activities are the movements on your cards: charges, repayments and adjustments. Every type, status and decline reason explained. - [Treasury](https://direct-api.reap.global/concepts/treasury/overview.md): Treasury gives you the funding information for your Reap balances: funding options, a wallet address or bank details, then your Treasury history. - [Funding methods](https://direct-api.reap.global/concepts/treasury/funding.md): Funding options tells you what your business can use; funding instructions returns fresh bank details or a wallet address for the method you chose. - [Treasury transactions](https://direct-api.reap.global/concepts/treasury/transactions.md): The transaction history is every movement on a balance (deposits, withdrawals, payments and adjustments) with filters and matching keys for reconciliation. - [Overview](https://direct-api.reap.global/api-reference/overview.md): Base URL, headers, request and response conventions, and your first authenticated call to the Business Account API. - [Authentication](https://direct-api.reap.global/api-reference/authentication.md): Send your API key in the x-api-key header on every request. Scopes decide which endpoints a key can call. - [Versioning](https://direct-api.reap.global/api-reference/versioning.md): The API version is a date in the URL path; breaking changes ship under a new dated version. - [Errors](https://direct-api.reap.global/api-reference/errors.md): Every error shares one envelope: status, type, message and often a code. Program against code when present, type otherwise, and retry only what this page marks retryable. - [Pagination](https://direct-api.reap.global/api-reference/pagination.md): List endpoints take page and limit and return items plus a meta block. Follow meta.totalPages, not a short page. - [Idempotency](https://direct-api.reap.global/api-reference/idempotency.md): POST /cards and POST /treasury/bank-transfer-confirmations accept an Idempotency-Key so retries can't create duplicates. - [Rate limits](https://direct-api.reap.global/api-reference/rate-limits.md): Requests are limited to 1000 per minute per API key; card creation is limited separately. Back off on 429. - [Error code catalog](https://direct-api.reap.global/api-reference/error-codes.md): Every error code the Business Account API can return, with its HTTP status, type, whether it is retryable, and the endpoints that return it. Generated from the OpenAPI documents. - [Polling and waiting](https://direct-api.reap.global/api-reference/polling.md): Every poll cadence and stop condition in the Business Account API, collected in one place. - [Create card](https://direct-api.reap.global/api-reference/2026-11-05/cards/create-card.md): Required API-key scope: `cards:write`. - [List cards](https://direct-api.reap.global/api-reference/2026-11-05/cards/list-cards.md): Required API-key scope: `cards:read`. - [Retrieve a card](https://direct-api.reap.global/api-reference/2026-11-05/cards/retrieve-a-card.md): Required API-key scope: `cards:read`. - [Edit card details](https://direct-api.reap.global/api-reference/2026-11-05/cards/edit-card-details.md): Required API-key scope: `cards:write`. - [Update spend control](https://direct-api.reap.global/api-reference/2026-11-05/cards/update-spend-control.md): Required API-key scope: `spend_controls:write`. - [Update card usage restriction](https://direct-api.reap.global/api-reference/2026-11-05/cards/update-card-usage-restriction.md): Required API-key scope: `cards:write`. - [Reveal card details](https://direct-api.reap.global/api-reference/2026-11-05/cards/reveal-card-details.md): Required API-key scope: `cards:read_vault`. - [Freeze card](https://direct-api.reap.global/api-reference/2026-11-05/cards/freeze-card.md): Required API-key scope: `cards:write`. - [Unfreeze card](https://direct-api.reap.global/api-reference/2026-11-05/cards/unfreeze-card.md): Required API-key scope: `cards:write`. - [Terminate card](https://direct-api.reap.global/api-reference/2026-11-05/cards/terminate-card.md): Required API-key scope: `cards:write`. - [Retrieve card-account balances](https://direct-api.reap.global/api-reference/2026-11-05/cards/retrieve-card-account-balances.md): Required API-key scope: `card_account_balances:read`. - [List card account activities](https://direct-api.reap.global/api-reference/2026-11-05/cards/list-card-account-activities.md): Required API-key scope: `card_activities:read`. Filter createdAt with inclusive gte and exclusive lt bounds. Status applies to CHARGE activities. Default order is createdAt descending, then id descending. Explicit timestamp sorts use id in the same direction. - [List card categories](https://direct-api.reap.global/api-reference/2026-11-05/cards/list-card-categories.md): Required API-key scope: `cards:read`. - [List transaction categories](https://direct-api.reap.global/api-reference/2026-11-05/cards/list-transaction-categories.md): Required API-key scope: `cards:read`. - [List team members](https://direct-api.reap.global/api-reference/2026-11-05/team-members/list-team-members.md): Required API-key scope: `team_members:read`. - [List Treasury funding options](https://direct-api.reap.global/api-reference/2026-11-05/treasury/list-treasury-funding-options.md): Required API-key scope: `treasury_funding:read`. - [Get Treasury funding instructions](https://direct-api.reap.global/api-reference/2026-11-05/treasury/get-treasury-funding-instructions.md): Required API-key scope: `treasury_funding:read`. - [Confirm a bank transfer](https://direct-api.reap.global/api-reference/2026-11-05/treasury/confirm-a-bank-transfer.md): Required API-key scope: `treasury_funding:write`. - [List Treasury transactions](https://direct-api.reap.global/api-reference/2026-11-05/treasury/list-treasury-transactions.md): Required API-key scope: `treasury_transactions:read`. - [Check API health](https://direct-api.reap.global/api-reference/2026-11-05/health/check-api-health.md): Checks that the API is reachable and that your API key is valid. It needs a key but no scope, so it's the simplest way to test a new key or monitor your integration. - [Changelog](https://direct-api.reap.global/changelog.md): New endpoints, new scopes and behavior changes in the Business Account API, newest first. - [Introduction](https://direct-api.reap.global/index.md): Manage cards, spend and Treasury funding for your Business Account from your own systems. - [Quickstart](https://direct-api.reap.global/quickstart.md): Go from a new API key to your first card in a few calls: check the key, find a cardholder, create a card, reveal it, then clean up. - [Get access and API keys](https://direct-api.reap.global/getting-started/access-and-api-keys.md): Who can request Business Account API access, how API keys are created, and the rules for scopes, IP allowlists and key lifecycle. - [Use the MCP server](https://direct-api.reap.global/getting-started/mcp-server.md): Connect Claude Code or Codex to your Business Account with an API key, choose when the assistant asks before it acts, and approve card changes safely. - [Issue cards to your team from your own system](https://direct-api.reap.global/guides/issue-cards-to-your-team.md): Create virtual cards for team members, reveal card details securely, and track spend and balances, all from your own tools. - [Issue cards for advertising campaigns at scale](https://direct-api.reap.global/guides/issue-cards-for-advertising.md): Create a dedicated virtual card for every ad account or campaign, give each one a fixed budget, limit it to advertising charges, and manage them all from your own system. - [Retrieve funding instructions and Treasury history](https://direct-api.reap.global/guides/retrieve-funding-instructions-and-treasury-history.md): Get the wallet address or bank details that make up the funding information for your account, confirm bank transfers, and follow every movement in and out of your Treasury from your own tools. - [Team members](https://direct-api.reap.global/concepts/team-members.md): Team members are the people on your Business Account. The API reads them so you can choose who holds a card. - [Cards](https://direct-api.reap.global/concepts/cards.md): Virtual cards belong to team members and carry a funding plan, a budget and spending limits. Every status and creation outcome explained. - [Spend controls](https://direct-api.reap.global/concepts/spend-controls.md): spendCap is a top-up card's total budget; spendControl limits throttle spending per transaction and per period; restriction limits the hours and merchant categories a card can be used in. Each is a full replacement. - [Approvals](https://direct-api.reap.global/concepts/approvals.md): If your business uses Approvals, cards created through the API wait for an approver in the dashboard before they're issued. - [Card details](https://direct-api.reap.global/concepts/card-details.md): The reveal endpoint returns a short-lived link to a Reap-hosted view of the card number, expiry and CVV, so card data never touches your servers. - [Card account balances](https://direct-api.reap.global/concepts/card-account.md): The card account is your business's shared credit pool. Balances explains the six figures that describe how much credit is in use. - [Card activities](https://direct-api.reap.global/concepts/activities.md): Card activities are the movements on your cards: charges, repayments and adjustments. Every type, status and decline reason explained. - [Treasury](https://direct-api.reap.global/concepts/treasury/overview.md): Treasury gives you the funding information for your Reap balances: funding options, a wallet address or bank details, then your Treasury history. - [Funding methods](https://direct-api.reap.global/concepts/treasury/funding.md): Funding options tells you what your business can use; funding instructions returns fresh bank details or a wallet address for the method you chose. - [Treasury transactions](https://direct-api.reap.global/concepts/treasury/transactions.md): The transaction history is every movement on a balance (deposits, withdrawals, payments and adjustments) with filters and matching keys for reconciliation. - [Overview](https://direct-api.reap.global/api-reference/overview.md): Base URL, headers, request and response conventions, and your first authenticated call to the Business Account API. - [Authentication](https://direct-api.reap.global/api-reference/authentication.md): Send your API key in the x-api-key header on every request. Scopes decide which endpoints a key can call. - [Versioning](https://direct-api.reap.global/api-reference/versioning.md): The API version is a date in the URL path; breaking changes ship under a new dated version. - [Errors](https://direct-api.reap.global/api-reference/errors.md): Every error shares one envelope: status, type, message and often a code. Program against code when present, type otherwise, and retry only what this page marks retryable. - [Pagination](https://direct-api.reap.global/api-reference/pagination.md): List endpoints take page and limit and return items plus a meta block. Follow meta.totalPages, not a short page. - [Idempotency](https://direct-api.reap.global/api-reference/idempotency.md): POST /cards and POST /treasury/bank-transfer-confirmations accept an Idempotency-Key so retries can't create duplicates. - [Rate limits](https://direct-api.reap.global/api-reference/rate-limits.md): Requests are limited to 1000 per minute per API key; card creation is limited separately. Back off on 429. - [Error code catalog](https://direct-api.reap.global/api-reference/error-codes.md): Every error code the Business Account API can return, with its HTTP status, type, whether it is retryable, and the endpoints that return it. Generated from the OpenAPI documents. - [Polling and waiting](https://direct-api.reap.global/api-reference/polling.md): Every poll cadence and stop condition in the Business Account API, collected in one place. - [Create card](https://direct-api.reap.global/api-reference/cards/create-card.md): Required API-key scope: `cards:write`. - [List cards](https://direct-api.reap.global/api-reference/cards/list-cards.md): Required API-key scope: `cards:read`. - [Retrieve a card](https://direct-api.reap.global/api-reference/cards/retrieve-a-card.md): Required API-key scope: `cards:read`. - [Edit card details](https://direct-api.reap.global/api-reference/cards/edit-card-details.md): Required API-key scope: `cards:write`. - [Update spend control](https://direct-api.reap.global/api-reference/cards/update-spend-control.md): Required API-key scope: `spend_controls:write`. - [Update card usage restriction](https://direct-api.reap.global/api-reference/cards/update-card-usage-restriction.md): Required API-key scope: `cards:write`. - [Reveal card details](https://direct-api.reap.global/api-reference/cards/reveal-card-details.md): Required API-key scope: `cards:read_vault`. - [Freeze card](https://direct-api.reap.global/api-reference/cards/freeze-card.md): Required API-key scope: `cards:write`. - [Unfreeze card](https://direct-api.reap.global/api-reference/cards/unfreeze-card.md): Required API-key scope: `cards:write`. - [Terminate card](https://direct-api.reap.global/api-reference/cards/terminate-card.md): Required API-key scope: `cards:write`. - [Retrieve card-account balances](https://direct-api.reap.global/api-reference/cards/retrieve-card-account-balances.md): Required API-key scope: `card_account_balances:read`. - [List card account activities](https://direct-api.reap.global/api-reference/cards/list-card-account-activities.md): Required API-key scope: `card_activities:read`. - [List card categories](https://direct-api.reap.global/api-reference/cards/list-card-categories.md): Required API-key scope: `cards:read`. - [List transaction categories](https://direct-api.reap.global/api-reference/cards/list-transaction-categories.md): Required API-key scope: `cards:read`. - [List team members](https://direct-api.reap.global/api-reference/team-members/list-team-members.md): Required API-key scope: `team_members:read`. - [List Treasury funding options](https://direct-api.reap.global/api-reference/treasury/list-treasury-funding-options.md): Required API-key scope: `treasury_funding:read`. - [Get Treasury funding instructions](https://direct-api.reap.global/api-reference/treasury/get-treasury-funding-instructions.md): Required API-key scope: `treasury_funding:read`. - [Confirm a bank transfer](https://direct-api.reap.global/api-reference/treasury/confirm-a-bank-transfer.md): Required API-key scope: `treasury_funding:write`. - [List Treasury transactions](https://direct-api.reap.global/api-reference/treasury/list-treasury-transactions.md): Required API-key scope: `treasury_transactions:read`. - [Check API health](https://direct-api.reap.global/api-reference/health/check-api-health.md): Checks that the API is reachable and that your API key is valid. It needs a key but no scope, so it's the simplest way to test a new key or monitor your integration. - [Changelog](https://direct-api.reap.global/changelog.md): New endpoints, new scopes and behavior changes in the Business Account API, newest first. ## OpenAPI Specs - [2026-07-13](/openapi/2026-07-13.json) - [2026-11-05](/openapi/2026-11-05.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.