Create Passes Batch

POST

api

passes

batch

Create pass batch

curl --request POST \
  --url https://api.passentry.com/api/v1/passes/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form csv='@example-file' \
  --form passTemplate=bf9d5cc29114

{
  "data": {
    "id": "999b774f-02ae-4931-94c6-596f614ef4f4",
    "type": "passCreation",
    "attributes": {
      "name": "Batch: Pass Creation 2025-11-21 15:34:02",
      "status": "processing",
      "passTemplateName": "PassEntry Ticketing",
      "passTemplateNameId": "acbb27e9cfb4e8f62f8cb999"
    }
  },
  "links": {
    "self": "https://api.passentry.com/api/v1/batches/999b774f-02ae-4931-94c6-596f614ef4f4"
  }
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

multipart/form-data

Batch

csv

file

required

CSV file containing pass data. 10 MB max size. Review the Batch Pass Creation guide for more information.

passTemplate

string

required

Pass Template ID.

name

string

Friendly name of the batch, used for display purposes. Auto-generated if not provided

Example:

"PassEntry Batch #1"

Response

Accepted

data

object

Show child attributes

data.id

string

UUID of the batch

data.type

enum<string>

Type of batch

Available options:

passCreation

data.attributes

object

Show child attributes

data.attributes.name

string

Friendly name of the batch, used for display purposes. Auto-generated if not provided

Example:

"PassEntry Batch #1"

data.attributes.status

enum<string>

Status of the batch

Available options:

processing,

successful,

failed

data.attributes.completedAt

string

ISO8601 timestamp of when the batch was completed

Example:

"2021-01-01T00:00:00Z"

data.attributes.passTemplateName

string

Name of the pass template

Example:

"PassEntry Ticketing"

data.attributes.passTemplateNameId

string

ID of the pass template

Example:

"acbb27e9cfb4e8f62f8cb999"

data.attributes.resultCsvUrl

string

URL to a CSV file containing the results of the batch

Example:

"https://example.com/errors.csv"

data.attributes.totalCount

integer

If present, total number of passes created in the batch

Example:

100

data.attributes.progress

object

Shown when batch is processing. Progress of the batch, can be polled for real-time updates.

Show child attributes

data.attributes.progress.total

integer

Total number of passes to be created in the batch

Example:

100

data.attributes.progress.processed

integer

Number of passes processed in the batch

Example:

90

data.attributes.progress.pending

integer

Number of passes pending to be created in the batch

Example:

10

links

object

Show child attributes

links.self

string

Self link to the batch record

Example:

"https://api.passentry.com/api/v1/batches/d29455c9-afe4-4c73-b946-a5ea0b1667f7"

Update Passes Batch [BETA]Update passes in bulk via a CSV file.

⌘I

Create pass batch

curl --request POST \
  --url https://api.passentry.com/api/v1/passes/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form csv='@example-file' \
  --form passTemplate=bf9d5cc29114

{
  "data": {
    "id": "999b774f-02ae-4931-94c6-596f614ef4f4",
    "type": "passCreation",
    "attributes": {
      "name": "Batch: Pass Creation 2025-11-21 15:34:02",
      "status": "processing",
      "passTemplateName": "PassEntry Ticketing",
      "passTemplateNameId": "acbb27e9cfb4e8f62f8cb999"
    }
  },
  "links": {
    "self": "https://api.passentry.com/api/v1/batches/999b774f-02ae-4931-94c6-596f614ef4f4"
  }
}

Introduction

Entities

Pass Templates

Passes

Readers

Scans

Loyalty

Webhook Subscriptions

Webhooks

Batches

Create Passes Batch

Authorizations

Body

Response