---
title: "Issue a signed Google Wallet pass"
method: POST
path: "/api/v1/passes/google-wallet"
tags: ["Passes", "Engage"]
---

# Issue a signed Google Wallet pass

`POST /api/v1/passes/google-wallet`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/v1/passes/google-wallet`
- Auth: HTTP bearer

Authenticated. Returns a signed savetowallet JWT and Google Wallet Save URL for the caller. Omit the body or passKind for a fan ID. Only Engage partner clubs the caller has joined qualify for club_membership. arena_event uses the game, the team, or a general pass when neither is supplied; signing does not perform arena check-in. The body is capped at 4 KiB.

## Request body

- object
  - `passKind` 'fan_id' | 'club_membership' | 'arena_event'
  - `teamId` string: Team ID or slug; trimmed before validation. Required for club_membership.
  - `gameId` string: Game event ID; trimmed before validation.

## Response `200`

Signed Google Wallet pass details

- GoogleWalletPassSuccess
  - `success` true, required
  - `data` object, required
    - `saveUrl` string, uri, required: Google Wallet Save URL containing the signed JWT.
    - `jwt` string, required: Signed Google Wallet savetowallet JWT.
    - `passKind` 'fan_id' | 'club_membership' | 'arena_event', required
    - `objectId` string, required
    - `classId` string, required

## Other responses

- `400`: VALIDATION_ERROR (invalid JSON or fields, or club_membership without teamId)
- `401`: UNAUTHORIZED
- `403`: FORBIDDEN (not a member of the requested Engage partner club)
- `404`: NOT_FOUND (team or game not found) or USER_NOT_PROVISIONED
- `413`: PAYLOAD_TOO_LARGE (body exceeds 4 KiB)
- `500`: Unexpected error issuing the pass
- `503`: CONFIGURATION_ERROR (missing or invalid Google Wallet signing configuration)

## Changes

- **2026-11-21** `300d0b9a863b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/v1/passes/google-wallet/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
