---
title: "Batch Create Budget Cards"
method: POST
path: "/open-api/v3/budget-cards"
tags: ["Card"]
---

# Batch Create Budget Cards

`POST /open-api/v3/budget-cards`

## Headers

- `Idempotency-Key` string, required

## Request body

- CreateBudgetCardReqDTO[]
  - `accountId` string, uuid, required — The UUID of the Account.
  - `binId` string, required — The Id of the bin.
  - `cardMode` 'PHYSICAL_CARD' | 'VIRTUAL_CARD', required — Card mode. Example: VIRTUAL_CARD
  - `useType` string — Custom use type. Example: Online advertising
  - `label` string — Custom card label or tag
  - `cardholderId` string, required — cardholder id
  - `physicalCardDesignId` string — Physical Card Design ID.
  - `ssn` string — If the card type is BB Card and the country is the United States, SSN is a mandatory parameter unless an SSN was already submitted during KYC or cardholder creation.
  - `referenceId` string, required — A unique identifier assigned by you for each card. This value must be unique per card request and will be used later to query or track the corresponding card.
  - `budgetId` string, uuid, required — The UUID of the Budget.

## Response `200`

OK

- BatchCardRespDTO
  - `code` string — Error code
  - `message` string — Error message
  - `data` BatchCard, required
    - `batchNumber` string, required — Batch number.
    - `taskId` string, required — taskId.

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/interlace/apis/core-resource.md) · [All operations](https://skmtc.net/interlace/apis/core-resource/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/interlace/core-resource/versions/29c08a4da357/schema)