---
title: "Submit bulk cards operations"
method: POST
path: "/bulk-cards"
tags: ["Cards Bulk Operations"]
---

# Submit bulk cards operations

`POST /bulk-cards`

Send Card details for Create/Update/Cancel/Patch Cards in bulk. Processing part will be asynchronous

## Query parameters

- `validateOnly` boolean, required
- `keepOperations` boolean, required

## Request body

- CardBulkCardsOpsRequest
  - `externalRef` string
  - `operations` CardBulkCardsOperation[], required
    - `id` string
    - `operationType` 'CREATE' | 'UPDATE' | 'PATCH' | 'CANCEL', required
    - `payload` unknown, required
    - `cardId` string
    - `accountId` string

## Response `202`

Accepted

- CardBulkCardsOpsResponse
  - `bulkRequestId` string
  - `submissionTimestamp` string, date-time
  - `status` 'SUBMITTED' | 'VALIDATED' | 'VALIDATED_WITH_ERRORS' | 'PROCESSING' | 'PARTIALLY_PROCESSED_WITH_ERRORS' | 'PARTIALLY_PROCESSED' | 'PROCESSED' | 'ARCHIVED' | 'DELETED'

## Other responses

- `400` — Invalid request
- `403` — Forbidden. Incorrect permissions

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/revisions/cbd52524c8ef/schema)