---
title: "Bulk ship physical cards"
method: POST
path: "/cards/bulk-ship"
tags: ["Physical Card", "Swipe"]
---

# Bulk ship physical cards

`POST /cards/bulk-ship`

## Headers

- `Accept-Version` string, required — Specifies the API version to use for this request.

## Request body

- object
  - `bulkshipID` string, uuid — The unique shipping ID provided after placing a bulk shipment order by calling the [POST /cards/bulk-ship](https://reap.readme.io/reference/post_cards-bulk-ship) endpoint.
  - `bulkShippingAddress` object, required — The delivery address for the bulk shipment of cards, typically a warehouse or distribution hub.
    - `line1` string, required — Address line 1 (e.g. flat, floor, building name).
    - `line2` string, nullable — Address line 2 (e.g. street, district).
    - `zone` string, nullable — State, county, province, or region.
    - `city` string, required — City, district, or town of the delivery address.
    - `postalCode` string, required — Postal code of the address. Only Arabic numerals **0-9**, Latin letters (A-Z, a-z), spaces, and hyphens (**-**) are allowed.
    - `country` string, required — Two-letter country code ([ISO 3166-1 Alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
  - `recipientInformation` object, required
    - `recipientFirstName` string, required
    - `recipientLastName` string, required
    - `recipientPhoneNumber` string, required
    - `recipientDialCode` number, float, required
    - `recipientEmail` string, email, required
  - `destinationShippingDetails` object[], required
    - `cardID` string, uuid, required
    - `shippingAddress` object, required — The end user's delivery address for this specific card in the shipment, which will always show on the card's envelope window.
      - `line1` string, required — Address line 1 (e.g. flat, floor, building name).
      - `line2` string, nullable — Address line 2 (e.g. street, district).
      - `zone` string, nullable — State, county, province, or region.
      - `city` string, required — City, district, or town of the delivery address.
      - `postalCode` string, required — Postal code of the address. Only Arabic numerals **0-9**, Latin letters (A-Z, a-z), spaces, and hyphens (**-**) are allowed.
      - `country` string, required — Two-letter country code ([ISO 3166-1 Alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2)).
    - `cardDesignID` string, required
  - `courier` object
    - `type` 'COURIER', required
    - `name` 'DHL' | 'FEDEX', required

## Response `200`

Triggered bulk shipping

- union
  - object
    - `bulkshipId` string
    - `successCount` number, float
    - `failedCount` number, float
    - `remainingSlots` number, float
    - `errors` object[]
      - `cardID` string, uuid, required
      - `message` string, required
      - `code` string, required
    - `cutoffDate` string
  - object
    - `bulkshipId` string
    - `successCount` number, float
    - `remainingSlots` number, float
    - `cutoffDate` string

## Other responses

- `207` — Triggered bulk shipping
- `400` — Invalid inputs or card is already in production / shipped
- `404` — Not found
- `406` — Not Acceptable

---

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