---
title: "Creates a single pass"
method: POST
path: "/api/v1/passes"
tags: ["Passes"]
---

# Creates a single pass

`POST /api/v1/passes`

## Request body

- PassCreateRequest
  - `issueDate` string, date, required — Issue Date for the pass.
  - `status` 'Active' | 'Suspended' | 'Cancelled', required
  - `suspendedUntil` string, date, nullable — If the pass is suspended when is it suspended until
  - `catalogEntryId` string, nullable — Which catalog entry id this pass is linked to
  - `isMultiSite` boolean, required — If True this pass is eligible for use as a multi-site pass.
  - `notes` string, nullable — Notes related to this pass
  - `expirationOverride` string, date, nullable — The date the expiration is overriden until if expired
  - `passTypeId` integer, required — The Pass Type of this pass.
  - `ageOfPassHolder` integer, nullable — Age Of Pass Holder.
  - `hasWaiver` boolean, required — If true there is a waiver
  - `isCustomer` boolean, required — If true there is a customer
  - `customerId` string, uuid, nullable — ID of the customer
  - `mediaNumber` string, nullable — Number identifying the media

## Response `201`

Created

- Pass — Represents a particular pass issued to a customer
  - `id` string, uuid, required — Unique identifier.
  - `issueDate` string, date, required — Issue Date for the pass.
  - `status` 'Active' | 'Suspended' | 'Cancelled', required
  - `suspendedUntil` string, date, nullable — If the pass is suspended when is it suspended until
  - `catalogEntryId` string, nullable — Which catalog entry id this pass is linked to
  - `isMultiSite` boolean, required — If True this pass is eligible for use as a multi-site pass.
  - `notes` string, nullable — Notes related to this pass
  - `expirationOverride` string, date, nullable — The date the expiration is overriden until if expired
  - `passTypeId` integer, required — The Pass Type of this pass.
  - `passUses` PassUse[], required — The uses of this pass
    - `type` 'RegularPassUse' | 'BuddyPassUse', required
    - `id` integer, required — Unique identifier.
    - `rainCheckUsed` boolean — Has a rain check been used on this pass use
    - `useDateTime` string, date — When this pass use occured
    - `isMultiSite` boolean — Is this a multi-site pass use
    - `useShiftDate` string, date — Which product id this pass is linked to
    - `target` PassUseTarget
      - `type` 'Product' | 'Device', required
  - `passStorageMethod` PassStorageMethod
    - `type` 'Customer' | 'Media', required

## Other responses

- `404` — Not Found

---

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