v1

latestOpenAPI 3.0.1MIT2026-07-261190449.2 KB
Card Accounts

Create Card Account

Creates a new card account for the specified organization.

post/card-accounts

Request body

organizationIdstring uuid required

The unique identifier of the organization.

namestring required

The name of the card account.

currencystring nullable

The currency code (e.g., EUR, USD).

Response

Card account created successfully

idstring uuid required

The id of the card account.

organizationIdstring uuid required

The id of the organization this card account belongs to.

namestring required

The name of the card account.

purposestring nullable

Optionally, a description of the purpose of the card account.

status'ACTIVE' | 'PENDING' | 'DEACTIVATED' | 'CANCELLED' required

The status of the card account.

currencystring required

The currency of the card account.

defaultAccountboolean required

Indicates whether this is the default card account. There is always one active default card account.

accountType'CREDIT' | 'PREFUNDED' required

The account type of the card account.

paymentFrequency'DAILY' | 'WEEKLY' | 'BI_WEEKLY' | 'MONTHLY' | 'PREFUNDED' required

The payment frequency of the card account. This is the frequency with which the card account is settled for this organization. Only relevant for CREDIT-based card accounts.

paymentDefermentInDaysinteger required

The payment deferment in days of the card account. Only relevant for CREDIT-based card accounts.

activatedAtstring date-time nullable

The date and time when the card account was activated.

createdAtstring date-time required

The date and time when the card account was created.

benefitCardAccountboolean

Set to true for the card account that is dedicated to funding benefit cards.