---
title: "Create multiple refund parcels in bulk"
method: POST
path: "/api/v{version}/parcels/bulk-refund"
tags: ["orders"]
---

# Create multiple refund parcels in bulk

`POST /api/v{version}/parcels/bulk-refund`

Creates up to 100 refund parcels in a single request.
        The supplier balance is checked before creation to ensure sufficient funds.

        Response Status Codes:
        - 200 OK: All parcels created successfully
        - 207 Multi-Status: Partial success (some parcels created, some failed)
        - 400 Bad Request: All parcels failed validation or creation

## Path parameters

- `version` string, required

## Headers

- `X-Tenant` string, required

## Request body

- CreateBulkParcelRefundRequest
  - `parcels` SingleParcelRefundRequest[], nullable
    - `customer` ParcelCustomerDto
      - `customerId` string, uuid
      - `name` string, nullable
      - `phone` PhoneDto
        - `number1` string, nullable
        - `number2` string, nullable
        - `number3` string, nullable
    - `deliveryAddress` DeliveryAddressInputDto
      - `cityTerritoryId` string, uuid
      - `districtTerritoryId` string, uuid
      - `street` string, nullable
    - `hubId` string, uuid, nullable
    - `deliveryType` string, nullable
    - `description` string, nullable
    - `amount` number, double
    - `externalId` string, nullable

## Response `200`

OK

- CreateBulkParcelRefundResponse
  - `totalRequested` integer
  - `successCount` integer
  - `failureCount` integer
  - `successes` BulkParcelRefundSuccess[], nullable
    - `index` integer
    - `parcelId` string, uuid
    - `trackingNumber` string, nullable
    - `externalId` string, nullable
  - `failures` BulkParcelRefundFailure[], nullable
    - `index` integer
    - `errorCode` string, nullable
    - `errorMessage` string, nullable
    - `externalId` string, nullable

## Other responses

- `207` — Multi-Status
- `400` — Bad Request

---

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