---
title: "Transfer a pass [Beta]"
method: POST
path: "/passes/{passId}/transfer"
---

# Transfer a pass \[Beta\]

`POST /passes/{passId}/transfer`

## Request

- Base URL: `https://api.sandbox.cleeng.com/3.1`
- URL: `https://api.sandbox.cleeng.com/3.1/passes/{passId}/transfer`
- Auth: API key in header `X-Publisher-Token`

Use this endpoint to transfer externally-managed passes between customers.

The life cycle of externally-managed passes is managed outside of Cleeng so it is up to a broadcaster to notify Cleeng about pass status changes, e.g. the change of pass expiration date.

## Path parameters

- `passId` integer, required

## Headers

- `Content-Type` string

## Request body

- object
  - `customerId` integer, required: The identifier of Cleeng customer.

## Response `200`

200

- object
  - `passId` integer
  - `customerId` integer
  - `status` string
  - `offerId` string
  - `expiresAt` integer
  - `paymentMethodId` integer
  - `externalId` string
  - `externalProperties` unknown[]
    - unknown
  - `isExternallyManaged` boolean
  - `replacedBy` object
    - `passId` integer
    - `reason` string
    - `date` integer
  - `originatedFrom` unknown
  - `source` string

## Other responses

- `400`: 400
- `404`: 404
- `422`: 422

---

[API](https://skmtc.dev/cleeng/apis/api-31.md) - [All operations](https://skmtc.dev/cleeng/apis/api-31/llms.txt) - [OpenAPI document](https://skmtc.dev/cleeng/apis/api-31/revisions/df55396cda4f?raw)