# NAS card-issuing API > Documentation for the NAS card-issuing API. Issue virtual and physical cards, verify customers, fund cards and read transactions. Sandbox base URL: https://sandbox-api.nas.cards. Production base URL: https://api.nas.cards. ## Guides - [NAS card-issuing API](https://docs.nas.cards/): Documentation for the NAS card-issuing API: onboard cardholders, issue virtual and physical cards, fund them and read transactions. - [Quick start](https://docs.nas.cards/quick-start): Go from your sandbox credentials to a virtual card with a simulated purchase on it, using the NAS API. - [Authentication](https://docs.nas.cards/authentication): Get an access token with the two-step OAuth flow, send it in the x-access-token header and renew it before it expires. - [Webhooks](https://docs.nas.cards/webhooks): Receive NAS webhook events for transactions, KYC results, deposits and shipments, and verify each signature before you trust it. - [Errors](https://docs.nas.cards/errors): The NAS API response envelope, how to read error codes and HTTP statuses, and which failures are safe to retry. - [Idempotency, pagination and limits](https://docs.nas.cards/idempotency-pagination-limits): Make card-issuing calls safe to repeat with idempotency keys, page through lists, and stay within NAS API rate limits. - [Account hierarchy](https://docs.nas.cards/account-hierarchy): How clients, programme accounts, customer accounts, cardholders, cards and wallets relate in the NAS API, and which id to send on each call. - [Environments](https://docs.nas.cards/environments): The NAS sandbox and production environments: base URLs, what differs between them and how production access is granted. - [Glossary](https://docs.nas.cards/glossary): Definitions of the terms used across the NAS API documentation, each linked to the page that covers it. - [Overview](https://docs.nas.cards/overview): How the NAS card-issuing API fits together: the account model, the steps from onboarding to spending, and where to start. - [KYC](https://docs.nas.cards/kyc): Verify a customer through the NAS API before issuing a card: collect details and images, submit KYC and read the result. - [Cards](https://docs.nas.cards/cards): Issue, fund, freeze, limit and close virtual cards with the NAS API: card types, BINs and the calls for each step. - [Card details](https://docs.nas.cards/card-details): Show a cardholder the full card number, expiry and security code through the secure display NAS hosts, without the details touching your server. - [Physical cards](https://docs.nas.cards/physical-cards): Order, ship and activate physical cards with the NAS API, and what differs from virtual cards. - [Transactions](https://docs.nas.cards/transactions): Read card transactions through the NAS API: purchases, refunds, transfers and fees, with filters and webhook events. - [Going live](https://docs.nas.cards/going-live): The checklist to complete in the NAS sandbox before NAS opens production access for your client. - [Wallets and funding](https://docs.nas.cards/wallets-and-funding): Take deposits into wallets, convert currencies and move money onto cards and budgets with the NAS API. - [Sandbox testing](https://docs.nas.cards/sandbox-testing): Use the NAS sandbox simulators for merchant purchases and KYC reviews to test your card-issuing integration. - [Test data](https://docs.nas.cards/test-data): What the NAS sandbox is known to accept and refuse, with the outcome to expect for each recorded test case. ## API reference - [Accounts](https://docs.nas.cards/reference/client/accounts): Accounts, onboarding and verification (KYC and KYB). - [Activate Physical Card](https://docs.nas.cards/reference/client/physical-card-activate): Activates a physical card after it has arrived. - [Authentication](https://docs.nas.cards/reference/client/authentication): Get and renew the access token used on every other call. - [Batch Create Budget Cards](https://docs.nas.cards/reference/client/batch-create-budget-card): Issues several budget cards in one call - [Batch Create Prepaid Cards](https://docs.nas.cards/reference/client/batch-create-prepaid-card): Issues several prepaid cards in one call - [Budgets](https://docs.nas.cards/reference/client/budgets): Shared pools of funds that budget cards draw on. - [Cardholders](https://docs.nas.cards/reference/client/cardholders): Cardholders and the card BINs they can be issued. - [Cards](https://docs.nas.cards/reference/client/cards): Issue, fund, freeze, limit and close cards, and read their transactions. - [Confirm Cardholder Identity](https://docs.nas.cards/reference/client/confirm-cardholder-identity): Confirms the identity of the cardholder of a physical card by submitting their ID document, where the programme asks for it before activation - [Conversion](https://docs.nas.cards/reference/client/conversion): Convert between currencies held in your wallets. - [Create a blockchain address](https://docs.nas.cards/reference/client/cryptoconnect-creation-wallet-address): Creates a deposit address on a blockchain for a wallet - [Create a trade](https://docs.nas.cards/reference/client/cryptoconnect-create-convert-trade): Converts one currency in your wallets to another - [Create a wallet](https://docs.nas.cards/reference/client/cryptoconnect-creation-wallet): Creates a wallet for an account. - [Create Budget](https://docs.nas.cards/reference/client/budget): Creates a budget, a shared pool of funds that budget cards can draw on. - [Create Budget Card](https://docs.nas.cards/reference/client/create-budget-card): Issues one card that draws on a budget instead of holding its own balance - [Create Cardholder](https://docs.nas.cards/reference/client/create-cardholder): Creates a cardholder under an account - [Create Prepaid Card](https://docs.nas.cards/reference/client/create-prepaid-card): Issues one prepaid card to a cardholder - [Decrease Budget Balance](https://docs.nas.cards/reference/client/sub-budget): Moves money from a budget back to the account balance. - [Delete Budget](https://docs.nas.cards/reference/client/remove-budget): Deletes a budget - [Delete Card](https://docs.nas.cards/reference/client/remove-card): Closes and deletes a card - [Delete Card BIN Spend Controls](https://docs.nas.cards/reference/client/delete-consumption-scenarios): Removes the spend controls set on a card BIN for an account. - [Files](https://docs.nas.cards/reference/client/files): Upload documents and images for verification. - [Freeze Card](https://docs.nas.cards/reference/client/suspend-card): Freezes a card so new authorisations are declined - [Generate an access token](https://docs.nas.cards/reference/client/get-access-token): Second step: exchange the one-time code, with your client id, for an access token and a refresh token - [Generate Cardholder Identity URL](https://docs.nas.cards/reference/client/cardholder-identity): Returns a link the cardholder can open to verify their identity themselves, as an alternative to submitting their ID document. - [Get a code](https://docs.nas.cards/reference/client/get-code): First step of getting an access token - [Get a trade currency pair](https://docs.nas.cards/reference/client/cryptoconnect-currency-pair): Returns the minimum amounts and trading symbol for converting between two currencies. - [Get a wallet](https://docs.nas.cards/reference/client/cryptoconnect-get-wallet): Returns one wallet with its balances and deposit addresses. - [Get an estimate quote](https://docs.nas.cards/reference/client/cryptoconnect-estimate-quote): Returns a price quote for converting one currency to another, with the rate, fee and how long the quote is valid - [Get Budget](https://docs.nas.cards/reference/client/get-budget): Returns one budget with its balance and settings. - [Get Budget Transaction Details](https://docs.nas.cards/reference/client/get-a-transactions): Returns one budget transaction. - [Get Card Access Token](https://docs.nas.cards/reference/client/get-private-info-access-token): Returns a short-lived token for showing the card number, expiry date and security code to the cardholder in a secure display, so the details never pass through your servers. - [Get Card BIN Spend Controls](https://docs.nas.cards/reference/client/get-consumption-scenarios): Returns the spend controls currently set on a card BIN for an account. - [Get Card Summary](https://docs.nas.cards/reference/client/card-summary): Returns the status, balance, limits and last four digits of a card - [Get Cardholder](https://docs.nas.cards/reference/client/get-cardholders): Returns one cardholder, including their verification status. - [Get KYB verification result](https://docs.nas.cards/reference/client/get-cdd-kyb): Returns the business verification (KYB) result for an account. - [Get KYC and KYB verification result](https://docs.nas.cards/reference/client/get-cdd-detail): Returns the current KYC and KYB verification result for an account, including the review status and any reason for rejection. - [Get Shipping Information](https://docs.nas.cards/reference/client/get-shipping-info): Returns the courier, tracking number and tracking link for a physical card - [Get the progress of a task](https://docs.nas.cards/reference/client/get-task-progressing): Returns the progress of an asynchronous task, such as a batch card order, so you can tell when it has finished and read its outcome. - [Get the recommended card BIN](https://docs.nas.cards/reference/client/get-platform-recommendation): Returns the card BIN recommended for a given spending scenario. - [Increase Budget Balance](https://docs.nas.cards/reference/client/add-budget): Moves money from the account balance into a budget. - [List all accounts](https://docs.nas.cards/reference/client/get-accounts): Returns the accounts your client can use, with their type and status - [List all blockchain transfers](https://docs.nas.cards/reference/client/cryptoconnect-list-transfers): Lists the crypto transfers on an account, with paging - [List all trades](https://docs.nas.cards/reference/client/cryptoconnect-list-convert-trades): Lists the conversions made for an account, with paging. - [List all wallets](https://docs.nas.cards/reference/client/cryptoconnect-list-wallets): Lists your wallets with their balances - [List Available Card BINs](https://docs.nas.cards/reference/client/get-card-bins): Lists the card BINs (card products) you can issue from, with the card types, currency, region and whether physical cards are supported. - [List Budget Transactions](https://docs.nas.cards/reference/client/get-budget-transaction-list): Lists the money movements on budgets for an account, with paging. - [List Budgets](https://docs.nas.cards/reference/client/get-budgets): Lists budgets for an account, with paging. - [List Card BINs Under Maintenance](https://docs.nas.cards/reference/client/get-card-bins-maintain): Lists the card BINs that are under maintenance, so you can avoid issuing from them until they return to service. - [List Card Transaction Scenarios](https://docs.nas.cards/reference/client/list-consumption-scenarios): Lists the transaction scenarios the platform defines, which you can then allow or block on a BIN or card. - [List Card Transactions](https://docs.nas.cards/reference/client/list-card-transactions): Lists card transactions for an account, with paging - [List Cardholders](https://docs.nas.cards/reference/client/list-cardholders): Lists cardholders for an account, newest first, with paging. - [List Cards](https://docs.nas.cards/reference/client/list-cards): Lists cards for an account, with paging - [List Physical Card Fees](https://docs.nas.cards/reference/client/get-physical-card-fees): Returns the fees for ordering and shipping physical cards by shipping zone, for a BIN and a number of cards. - [List webhook deliveries](https://docs.nas.cards/reference/client/list-webhook-deliveries): Lists the webhook events sent to your webhook URL, newest first, and how each one went - [NAS Card Issuing API](https://docs.nas.cards/reference/client/nas-card-issuing-api): Issue and manage cards for your customers: onboard accounts and cardholders, issue virtual and physical cards, set spending controls, fund cards and budgets, and read transactions. - [Order physical card shipping](https://docs.nas.cards/reference/client/physical-card-bulk-ship): Orders physical cards for shipping to a cardholder address - [Physical cards](https://docs.nas.cards/reference/client/physical-cards): Order, verify and activate physical cards. - [Prepaid Card Transfer In](https://docs.nas.cards/reference/client/card-transfer-in): Moves money from the account balance onto a prepaid card - [Prepaid Card Transfer Out](https://docs.nas.cards/reference/client/card-transfer-out): Moves money from a prepaid card back to the account balance - [Refresh access token](https://docs.nas.cards/reference/client/refresh-access-token): Exchanges a refresh token for a new access token and refresh token, before or after the access token expires - [Register an account](https://docs.nas.cards/reference/client/register-account): Registers a new account under one of your accounts, for onboarding a customer of your own - [Set Card BIN Spend Controls](https://docs.nas.cards/reference/client/consumption-scenarios): Sets which transaction scenarios cards on a BIN may be used for, for an account. - [Set Card Transaction Scenarios](https://docs.nas.cards/reference/client/set-consumption-scenario): Sets the transaction scenarios (merchant categories and similar) a single card is allowed to be used for. - [Set card velocity controls](https://docs.nas.cards/reference/client/set-card-velocity-control): Sets the spending limits on a card, such as a maximum per transaction, per day, per month or over the card's lifetime. - [Simulate Card Authorization Requests](https://docs.nas.cards/reference/client/simulate-authorization): Sandbox only: this operation exists on the sandbox host and is not available in production - [Simulate Card Refund Requests](https://docs.nas.cards/reference/client/simulate-refund): Sandbox only: this operation exists on the sandbox host and is not available in production - [Simulate Card Reversal Requests](https://docs.nas.cards/reference/client/simulate-reversal): Sandbox only: this operation exists on the sandbox host and is not available in production - [Simulate KYC Review](https://docs.nas.cards/reference/client/simulate-kyc-review): Sandbox only: this operation exists on the sandbox host and is not available in production - [Spend controls](https://docs.nas.cards/reference/client/spend-controls): Allow or block transaction scenarios on cards and card BINs. - [Submit account KYB](https://docs.nas.cards/reference/client/submit-account-kyb): Submits the business details and documents for an account's KYB review - [Submit account KYC](https://docs.nas.cards/reference/client/submit-account-kyc): Submits an individual's identity details and document images for an account's KYC review - [Testing](https://docs.nas.cards/reference/client/testing): Sandbox-only simulators. These operations do not exist in production. - [Unfreeze Card](https://docs.nas.cards/reference/client/enable-card): Unfreezes a card that was frozen, so it can authorise again. - [Update a wallet](https://docs.nas.cards/reference/client/cryptoconnect-update-wallet): Updates the label or settings of a wallet - [Update Budget](https://docs.nas.cards/reference/client/update-budget): Updates the name or settings of a budget - [Update Cardholder](https://docs.nas.cards/reference/client/update-cardholder): Updates the contact or address details of a cardholder - [Update PIN](https://docs.nas.cards/reference/client/update-card-pin): Sets or changes the PIN of a card - [Upload files](https://docs.nas.cards/reference/client/upload-file): Uploads one or more image or document files as multipart/form-data and returns an id for each - [Wallets](https://docs.nas.cards/reference/client/wallets): Your wallets and their deposit addresses. - [Webhook deliveries](https://docs.nas.cards/reference/client/webhook-deliveries): See which webhook events were delivered to you, and which failed for good. ## Webhook events - [ACCOUNT.DAILY.NEGATIVE](https://docs.nas.cards/reference/webhooks/event-account-daily-negative): An account ended the day with a negative balance - [ACCOUNT.REGISTERED](https://docs.nas.cards/reference/webhooks/event-account-registered): An account was registered - [Accounts and verification](https://docs.nas.cards/reference/webhooks/accounts-and-verification): An account was registered. The `resource` field is a JSON string describing the account. - [BLOCKCHAIN_REFUND.CREATED](https://docs.nas.cards/reference/webhooks/event-blockchain-refund-created): A refund of a wallet deposit was created - [BLOCKCHAIN_REFUND.UPDATE](https://docs.nas.cards/reference/webhooks/event-blockchain-refund-update): A refund of a wallet deposit changed state - [BLOCKCHAIN_TRANSFER.CREATED](https://docs.nas.cards/reference/webhooks/event-blockchain-transfer-created): A deposit to one of your wallets was detected - [BLOCKCHAIN_TRANSFER.UPDATE](https://docs.nas.cards/reference/webhooks/event-blockchain-transfer-update): A deposit to one of your wallets completed or changed state, including when a deposit is flagged as high risk and held - [BUDGET_TRANSACTION.CREATED](https://docs.nas.cards/reference/webhooks/event-budget-transaction-created): Money moved into or out of a budget - [BUDGET.CREATED](https://docs.nas.cards/reference/webhooks/event-budget-created): A budget was created - [BUDGET.DELETED](https://docs.nas.cards/reference/webhooks/event-budget-deleted): A budget was deleted - [BUDGET.UPDATED](https://docs.nas.cards/reference/webhooks/event-budget-updated): A budget changed - [Budgets](https://docs.nas.cards/reference/webhooks/budgets): A budget was created. The `resource` field is a JSON string describing the budget. - [CARD_TRANSACTION.CREATED](https://docs.nas.cards/reference/webhooks/event-card-transaction-created): A card transaction was created, such as an authorisation - [CARD_TRANSACTION.UPDATED](https://docs.nas.cards/reference/webhooks/event-card-transaction-updated): A card transaction changed, such as a settlement, refund or reversal - [CARD.3DS.OTP](https://docs.nas.cards/reference/webhooks/event-card-3-ds-otp): A card payment needs a one-time code for 3-D Secure verification - [CARD.BALANCE.NEGATIVE](https://docs.nas.cards/reference/webhooks/event-card-balance-negative): A card balance went negative - [CARD.CHARGE](https://docs.nas.cards/reference/webhooks/event-card-charge): The retry charge notification, sent every 2 hours while a card balance is negative; it settles the shortfall fully or partially - [CARD.DELETED](https://docs.nas.cards/reference/webhooks/event-card-deleted): A card was deleted - [CARD.SCENE.UPDATED](https://docs.nas.cards/reference/webhooks/event-card-scene-updated): The transaction scenarios allowed on a card changed - [CARD.SETTING.UPDATED](https://docs.nas.cards/reference/webhooks/event-card-setting-updated): The payment mode of a card changed - [CARD.UPDATED](https://docs.nas.cards/reference/webhooks/event-card-updated): The details of a card changed - [CARDHOLDER.DELETED](https://docs.nas.cards/reference/webhooks/event-cardholder-deleted): A cardholder was deleted - [CARDHOLDER.UPDATED](https://docs.nas.cards/reference/webhooks/event-cardholder-updated): The details of a cardholder changed - [Cardholders](https://docs.nas.cards/reference/webhooks/cardholders): The details of a cardholder changed. The `resource` field is a JSON string describing the cardholder. - [Cards](https://docs.nas.cards/reference/webhooks/cards): The details of a card changed. The `resource` field is a JSON string describing the card. - [CRYPTO_ASSETS_BLOCKCHAIN_ADDRESS.UPDATED](https://docs.nas.cards/reference/webhooks/event-crypto-assets-blockchain-address-updated): A deposit address was frozen, or a deposit to it was put on hold - [KYB.UPDATED](https://docs.nas.cards/reference/webhooks/event-kyb-updated): The KYB verification status of an account changed - [KYC.UPDATED](https://docs.nas.cards/reference/webhooks/event-kyc-updated): The KYC verification status of an account changed - [NAS Card Issuing Webhook Events](https://docs.nas.cards/reference/webhooks/nas-card-issuing-webhook-events): Events are sent as HTTP POST requests to the callback URL registered for your client, one request per event. - [PHYSICAL_CARD.ACTIVATED](https://docs.nas.cards/reference/webhooks/event-physical-card-activated): A physical card was activated - [PHYSICAL_CARD.SHIPPING](https://docs.nas.cards/reference/webhooks/event-physical-card-shipping): Shipping information for a physical card is available or changed - [PHYSICAL_CARD.VERIFY](https://docs.nas.cards/reference/webhooks/event-physical-card-verify): A physical card needs the cardholder to be verified before activation - [PROVIDER_FEES_CHANGED](https://docs.nas.cards/reference/webhooks/event-provider-fees-changed): The deposit fees that apply to your client changed - [Wallet deposits](https://docs.nas.cards/reference/webhooks/wallet-deposits): A deposit to one of your wallets completed or changed state, including when a deposit is flagged as high risk and held. The `resource` field is a JSON string describing the blockchain transfer. ## Specification - [OpenAPI specification](https://docs.nas.cards/openapi.yaml): the machine-readable definition of the client API, in OpenAPI 3.1 YAML. ## Optional - [Changelog](https://docs.nas.cards/changelog): Changes to the NAS card-issuing API and its documentation.