Create a card

Allows creating a card of different types with different limit configurations. Access to this endpoint must be requested via support team.

POST /cards

Create a card

cURL

curl --request POST \
  --url https://api.dash.fi/v1/public/cards \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "categories": [
    "ad-card"
  ],
  "limit": {
    "amount": "100.00"
  },
  "name": "adspend card meta",
  "expiry": "202512"
}
'

201

{
  "id": "550e8400-e29b-41d4-a716-446655440000"
}

Authorizations

Authorization · string · header · required

Type "Bearer" followed by a space and your API token. Obtain your key from the Dash.fi dashboard. Example: "Bearer YOUR_API_KEY"

Body

application/json

Card creation request

Card creation request

categories · enum<string>[] · required

Card categories. Categories have specific MCC restrictions.

Available options: advertising, saas_software, shipping, cloud_computing, professional_services, airlines, books_and_newspapers, car_rental, car_services, charitable_donations, clothing, clubs_and_memberships, education, electronics, fees_and_financial_institutions, freight_moving_and_delivery_services, fuel_and_gas, general_merchandise, general_expenses, government_services, insurance, internet_and_phone, legal, lodging, medical, office_supplies_and_cleaning, other, parking, pet, restaurants, supermarkets_and_grocery_stores, taxes_and_tax_preparation, taxi_and_rideshare, travel_misc, utilities, entertainment

Example:

["ad-card"]

limit · object · required

Limit to set on card.

Show child attributes

name · string · required

Card name. Card name must be unique for cards created unless the previous card with the same name has been archived.

Example:

"adspend card meta"

type · enum<string> · required

Card type. Single-use can be used for a single transaction (exluding auths up to 5$). Recurring can be used for multiple transactions.

Available options: single-use, recurring

expiry · string

Card expiry in YYYYMM format. Cannot be in the past. Earliest possible is current month. Generates random expiration if not provided.

Example:

"202512"

Response

201

application/json

Created card response

id · string<uuid> · required

Card ID.

Example:

"550e8400-e29b-41d4-a716-446655440000"