Get a pass update

curl https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe/updates/pupd_Lm4Xq8Vt2Nr7Kz3Pw9Bc \
  -H "Authorization: Bearer $TAPACE_API_KEY"

{
  "object": "pass_update",
  "id": "pupd_Lm4Xq8Vt2Nr7Kz3Pw9Bc",
  "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
  "actor": { "id": "cmgx4k2p90001ab12cd34ef56", "name": null, "email": null },
  "notificationMode": "notify",
  "walletChanged": true,
  "changes": {
    "fields": [
      { "key": "points", "label": "Points", "from": "120", "to": "150" }
    ]
  },
  "googleMessage": { "header": "Pass updated", "body": "Points: 150" },
  "delivery": {
    "apple": { "status": "delivered", "devices": 1, "error": null },
    "google": { "status": "delivered", "message": "sent", "error": null }
  },
  "retryable": false,
  "createdAt": "2026-10-13T10:30:00.000Z",
  "updatedAt": "2026-10-13T10:30:04.000Z"
}

{
  "error": {
    "type": "not_found_error",
    "message": "Update not found."
  },
  "requestId": "req_8f3a2c1d9e7b6a54"
}

GET

passes

{id}

updates

{updateId}

curl https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe/updates/pupd_Lm4Xq8Vt2Nr7Kz3Pw9Bc \
  -H "Authorization: Bearer $TAPACE_API_KEY"

{
  "object": "pass_update",
  "id": "pupd_Lm4Xq8Vt2Nr7Kz3Pw9Bc",
  "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
  "actor": { "id": "cmgx4k2p90001ab12cd34ef56", "name": null, "email": null },
  "notificationMode": "notify",
  "walletChanged": true,
  "changes": {
    "fields": [
      { "key": "points", "label": "Points", "from": "120", "to": "150" }
    ]
  },
  "googleMessage": { "header": "Pass updated", "body": "Points: 150" },
  "delivery": {
    "apple": { "status": "delivered", "devices": 1, "error": null },
    "google": { "status": "delivered", "message": "sent", "error": null }
  },
  "retryable": false,
  "createdAt": "2026-10-13T10:30:00.000Z",
  "updatedAt": "2026-10-13T10:30:04.000Z"
}

{
  "error": {
    "type": "not_found_error",
    "message": "Update not found."
  },
  "requestId": "req_8f3a2c1d9e7b6a54"
}

Updating a pass returns an update whose delivery usually starts as pending. Fetch it again with its ID to see when each wallet has the change.

string

required

The pass ID.

string

required

The update ID, starting with pupd_.

The pass update object

string

Unique ID, starting with pupd_.

string

The pass that changed.

object | null

Who made the change: id, name and email. For a change made through the API, id is the API key’s ID and the other two are null.

string

silent or notify.

boolean

Whether the change is visible in wallets. Changes to holder details made in the dashboard are recorded with false and aren’t delivered.

object

What changed.

Show properties

array

Each changed field with its key, label, from and to values.

object

from and to, when the barcode value changed.

array

Each Featured Action whose link changed, with its key, type, from and to links. null stands for no link.

object

from and to, when the pass’s Lock Screen lists changed. Each holds the locations and dates the pass shows, including any it takes from the template.

object

from and to counts and the card’s total, when a stamp card’s count changed.

object

When a points card’s balance changed: from and to balances, change, the amount asked for (it stays as sent even when a limit stopped the balance short, and for a deployment it’s the difference), and the template’s goal, or null without one.

object

Present when the change came from saving the template’s event details: eventUpdateId, the tevu_ ID of that save.

object

from and to, when the holder’s name changed in the dashboard. holderEmail works the same way.

object

Present when the change came from rolling out a new template design: deploymentId, fromRevision, toRevision and notified.

boolean

true when this update voided the pass.

object | null

The header and body of the notification sent to Google Wallet, when there is one.

object

Progress per wallet.

Show properties

object

status (see delivery status), devices, the number of Apple devices the update was sent to, and error, which explains a failed status.

object

status, error, and message: the state of the Google notification, which is not_requested, pending, sent, limit_reached or failed.

boolean

true when this is the pass’s latest wallet change, a wallet failed to receive it, and nothing is still pending. It can then be resent from the pass’s page in the dashboard.

string

When the change was made.

string

When its delivery status last changed.

Errors

Status	When
`404`	The pass or the update doesn’t exist.

curl https://api.tapace.lk/v1/passes/pass_7hGk2LmQ9xVt4RnB8cYe/updates/pupd_Lm4Xq8Vt2Nr7Kz3Pw9Bc \
  -H "Authorization: Bearer $TAPACE_API_KEY"

{
  "object": "pass_update",
  "id": "pupd_Lm4Xq8Vt2Nr7Kz3Pw9Bc",
  "passId": "pass_7hGk2LmQ9xVt4RnB8cYe",
  "actor": { "id": "cmgx4k2p90001ab12cd34ef56", "name": null, "email": null },
  "notificationMode": "notify",
  "walletChanged": true,
  "changes": {
    "fields": [
      { "key": "points", "label": "Points", "from": "120", "to": "150" }
    ]
  },
  "googleMessage": { "header": "Pass updated", "body": "Points: 150" },
  "delivery": {
    "apple": { "status": "delivered", "devices": 1, "error": null },
    "google": { "status": "delivered", "message": "sent", "error": null }
  },
  "retryable": false,
  "createdAt": "2026-10-13T10:30:00.000Z",
  "updatedAt": "2026-10-13T10:30:04.000Z"
}

{
  "error": {
    "type": "not_found_error",
    "message": "Update not found."
  },
  "requestId": "req_8f3a2c1d9e7b6a54"
}

Getting started

Basics

Guides

Node.js SDK

API keys

Passes

Loyalty cards

Notifications

Templates

Wallet signing

Deployments

Assets

Get a pass update

The pass update object

Errors

​The pass update object

​Errors

The pass update object

Errors