---
title: "Retrieve the mobile pass customisation"
method: GET
path: "/customers/sites/{siteId}/mobile-pass-customisation"
tags: ["Sites"]
---

# Retrieve the mobile pass customisation

`GET /customers/sites/{siteId}/mobile-pass-customisation`

Retrieves the mobile pass customisation for the given site. The customisation controls
the visual appearance of digital wallet passes (Apple Wallet / Google Wallet) issued to
members.

## Response `200`

The mobile pass customisation for the site was successfully retrieved or updated.

- object
  - `data` MobilePassCustomisation, required — Visual customisation for a site's mobile pass — Apple Wallet / Google Wallet — including the icon, logo, strip image and colour scheme. Each media reference points to a `Media` record uploaded via the media endpoints.
    - `enabled` boolean, required — Whether or not mobile passes are enabled for this site
    - `icon_id` string, uuid — The id of the icon
    - `icon` Media
      - `id` string, uuid, required — Unique identifier of the uploaded media item, returned from `createMedia`. Pass this ID into any field that accepts a media reference (logos, hero images, product images, etc.).
      - `file_name` string, required — Original filename of the uploaded asset, preserved as provided at upload time. Used for display in the media library and as a hint when serving downloads.
      - `mime_type` string, required — The mime type of the media item.
      - `original_url` string, required — The url of the media resource.
      - `size` integer, required — The size of the media item in bytes.
      - `url` string, required — The url of the converted media resource.
    - `logo_id` string, uuid — The id of the logo
    - `logo` Media
      - `id` string, uuid, required — Unique identifier of the uploaded media item, returned from `createMedia`. Pass this ID into any field that accepts a media reference (logos, hero images, product images, etc.).
      - `file_name` string, required — Original filename of the uploaded asset, preserved as provided at upload time. Used for display in the media library and as a hint when serving downloads.
      - `mime_type` string, required — The mime type of the media item.
      - `original_url` string, required — The url of the media resource.
      - `size` integer, required — The size of the media item in bytes.
      - `url` string, required — The url of the converted media resource.
    - `strip_id` string, uuid — The id of the strip image
    - `strip` Media
      - `id` string, uuid, required — Unique identifier of the uploaded media item, returned from `createMedia`. Pass this ID into any field that accepts a media reference (logos, hero images, product images, etc.).
      - `file_name` string, required — Original filename of the uploaded asset, preserved as provided at upload time. Used for display in the media library and as a hint when serving downloads.
      - `mime_type` string, required — The mime type of the media item.
      - `original_url` string, required — The url of the media resource.
      - `size` integer, required — The size of the media item in bytes.
      - `url` string, required — The url of the converted media resource.
    - `background_colour` string — A hex colour code excluding the preceding `#` for the background
    - `foreground_colour` string — A hex colour code excluding the preceding `#` for the foreground
    - `label_colour` string — A hex colour code excluding the preceding `#` for the labels

## Other responses

- `401` — The user is unauthenticated
- `404` — The resource couldn't be found

---

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