For AI agents: a documentation index is available at the root level at /llms.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Issue a virtual card under an existing card product. For a single_reload product, set load_amount to the card’s lifetime budget.
Required permissions: card:create.
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Request
This endpoint expects an object.
card_product_idstringRequired
The card product to issue the card under.
capital_account_idstringRequired
The capital account that funds the card's spending.
cardholder_idstringOptional
Existing cardholder that owns the card. Exactly one of cardholder_id or cardholder must be supplied.
cardholderobject or nullOptional
Inline cardholder-creation payload; the cardholder is created first and then assigned to the new card. Exactly one of cardholder_id or cardholder must be supplied.
control_account_idstringOptional
A control account to delegate control of this card’s spending to. Funds still come from capital_account_id.
spend_control_idstringOptional
A spend control to assign to the card. Its rules apply to every authorization on the card.
expiration_datedate or nullOptional
Expiration date for the card. Omit to use the product’s default_expiration_months; must fall within its max_expiration_months, when set.
aliasstring or nullOptional
A display name for the card, such as "Marketing team".
descriptionstring or nullOptional
A longer description of what the card is for.
activebooleanOptionalDefaults to true
Whether the card should be active on issuance.
load_amountstring or nullOptional
The total the card can ever spend, as a decimal string in the card’s currency (USD). Required when the card product’s usage_type is single_reload, and rejected for any other usage type. Pending authorizations and settled spend count against it, authorizations that expire or are cancelled return their amount, and it cannot be raised after issuance.
Response
The newly issued virtual card.
card_idstring
Penny's unique identifier for this card.
versioninteger
A number that increases each time this card's details change. Use it to confirm you are looking at the latest information.
version_timedatetime
The date and time this card's details were last changed.
issued_timedatetime
The date and time this card was issued.
expiration_datedate
The date this card expires and can no longer be used.
bin_idstring
The BIN this card was issued under.
bin_range_idstring
The BIN range this card was issued under.
card_product_idstring
The card product this card was issued under.
business_idstring
The business that owns this card.
business_entity_idstring
The business entity associated with this card.
program_idstring
The program this card was issued under.
capital_account_idstring
The account this card draws funds from.
cardholder_idstring
The cardholder this card is issued to.
statusenum
This card's current lifecycle status.
Allowed values:
activeboolean
Whether this card is currently able to authorize transactions.
terminatedboolean
Whether this card has been permanently terminated.
currencyenum
The currency this card transacts in.
Allowed values:
countrystring
The country this card was issued in, as an ISO 3166-1 alpha-2 code.
usage_typeenum
The usage type this card was issued for.
Allowed values:
scheme_detailsobject
The card network scheme details for this card.
terminated_timedatetime or nullOptional
The date and time this card was terminated, if it has been.
binstring or nullOptional
The first 6-8 digits of the card number, as displayed to end users.
last_fourstring or nullOptional
The last four digits of the card number, as displayed to end users.
control_account_idstring or nullOptional
The control account controlling this card's spend, if one is delegated.
usage_limitsobject or nullOptional
The limits enforcing usage_type and how much of them is used. Present on single_use and single_reload cards only.
aliasstring or nullOptional
A human-readable name for this card, if one has been set.
descriptionstring or nullOptional
A description of this card's purpose, if one has been set.
spend_control_idstring or nullOptional
The spend control policy applied to this card, if one is set.
client_referenceobject or nullOptional
An opaque reference the client attached to this card for their own tracking purposes.
