Update Passes Batch [BETA]

POST

api

passes

batch

update

Update pass batch

curl --request POST \
  --url https://api.passentry.com/api/v1/passes/batch/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form csv='@example-file' \
  --form tag=summerPromotion \
  --form 'name=Summer Promotion Update #1' \
  --form scheduledAt=2030-03-31T13:16:26Z

{
  "data": {
    "id": "999b774f-02ae-4931-94c6-596f614ef4f4",
    "type": "passUpdate",
    "attributes": {
      "name": "Batch: Pass Update 2025-11-21 15:34:02",
      "status": "validating",
      "tag": "summerPromotion",
      "passTemplateName": "PassEntry Loyalty",
      "passTemplateNameId": "acbb27e9cfb4e8f62f8cb999",
      "scheduledAt": "2024-01-01T00:00:00Z",
      "errorsCsvUrl": "https://example.com/errors.csv",
      "totalCount": 1000,
      "progress": {
        "total": 1000,
        "processed": 800,
        "pending": 200
      }
    }
  },
  "links": {
    "self": "https://api.passentry.com/api/v1/batches/999b774f-02ae-4931-94c6-596f614ef4f4"
  }
}

This endpoint is currently in BETA.
Please let us know if you encounter any issues or have feedback.

Authorizations

Authorization

string

header

required

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

Body

multipart/form-data

Batch Update

csv

file

required

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

passTemplate

string

required

Pass Template ID.

scheduledAt

string

required

ISO8601 timestamp of when the batch is scheduled to be updated

name

string

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

Example:

"PassEntry Summer Promotion Update"

tag

string

Tag of the batch, used for grouping and filtering purposes

Example:

"summerPromotion"

Response

Accepted

data

object

Show child attributes

data.id

string

UUID of the batch

data.type

enum<string>

Type of batch

Available options:

passUpdate

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 Summer Promotion Update #1"

data.attributes.status

enum<string>

Status of the batch

Available options:

validating,

scheduled,

failed,

updating,

successful,

completedWithErrors,

cancelled

data.attributes.tag

string

Tag of the batch, used for grouping and filtering purposes

Example:

"summerPromotion"

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.completedAt

string

ISO8601 timestamp of when the batch was completed

Example:

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

data.attributes.errorsCsvUrl

string

If present, batch failed validation, or had some errors during update. URL to a CSV file containing errors and error details of the batch

Example:

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

data.attributes.totalCount

integer

If present, total number of passes to be updated in the batch

Example:

100

data.attributes.progress

object

Shown when batch is validating or updating. 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"

Create Passes BatchCreate passes in bulk via a CSV file. For more details, see the [Batch Pass Creation](/documentation/bulk-operations/batch-pass-creation/guide) documentation.

⌘I

Update pass batch

curl --request POST \
  --url https://api.passentry.com/api/v1/passes/batch/update \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form csv='@example-file' \
  --form tag=summerPromotion \
  --form 'name=Summer Promotion Update #1' \
  --form scheduledAt=2030-03-31T13:16:26Z

{
  "data": {
    "id": "999b774f-02ae-4931-94c6-596f614ef4f4",
    "type": "passUpdate",
    "attributes": {
      "name": "Batch: Pass Update 2025-11-21 15:34:02",
      "status": "validating",
      "tag": "summerPromotion",
      "passTemplateName": "PassEntry Loyalty",
      "passTemplateNameId": "acbb27e9cfb4e8f62f8cb999",
      "scheduledAt": "2024-01-01T00:00:00Z",
      "errorsCsvUrl": "https://example.com/errors.csv",
      "totalCount": 1000,
      "progress": {
        "total": 1000,
        "processed": 800,
        "pending": 200
      }
    }
  },
  "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

Update Passes Batch [BETA]

Authorizations

Body

Response