---
title: "Create pass batch"
method: POST
path: "/api/v1/passes/batch"
tags: ["Batches"]
---

# Create pass batch

`POST /api/v1/passes/batch`

Create passes in bulk via a CSV file. 

 For more details, see the [Batch Pass Creation](/documentation/bulk-operations/batch-pass-creation/guide) documentation.

## Response `202`

Accepted

- object
  - `data` SerializedPassCreationBatch
    - `id` string — UUID of the batch
    - `type` 'passCreation' — Type of batch
    - `attributes` object
      - `name` string — Friendly name of the batch, used for display purposes. Auto-generated if not provided
      - `status` 'processing' | 'successful' | 'failed' — Status of the batch
      - `completedAt` string — ISO8601 timestamp of when the batch was completed
      - `passTemplateName` string — Name of the pass template
      - `passTemplateNameId` string — ID of the pass template
      - `resultCsvUrl` string — URL to a CSV file containing the results of the batch
      - `totalCount` integer — If present, total number of passes created in the batch
      - `progress` object — Shown when batch is processing. Progress of the batch, can be polled for real-time updates.
        - `total` integer — Total number of passes to be created in the batch
        - `processed` integer — Number of passes processed in the batch
        - `pending` integer — Number of passes pending to be created in the batch
  - `links` BatchSelfLink
    - `self` string — Self link to the batch record

## Other responses

- `401` — Error: Unauthorized

---

[API](https://skmtc.dev/passentry/apis/passentry-api.md) · [All operations](https://skmtc.dev/passentry/apis/passentry-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/passentry/passentry-api/revisions/3b24e067f9d9/schema)
