Changelog

Atom feed

Send PassBook-Version to opt in to a dated version; without it nothing changes.

PassBook-Version: 2026-11-20POST /roll-calls answers 201 when it starts a roll call.

Send PassBook-Version: 2026-11-20 to opt in. POST /roll-calls then returns 201, not 200. Without the header nothing changes.

2026-11-20

Addedx-sdk names on every operation: the SDK resource and method, frozen.General
AddedChild keys: mint, list, read, rotate, retire and revoke keys under a service key (api-keys:write).API keys
AddedcreatedAfter, createdBefore and updatedSince beside from, to and since.General
ChangedEvery collection GET returns items and nextCursor, and takes cursor. after stays on /events and /scan/live.General
ChangedProblem type is https://passbook.mobile/developers/errors/<CODE>, not urn:wallet:problem:<code>. Branch on code.General
AddedError catalog: every operation lists its x-codes, and each code has a page with a fix.General
AddedDeveloper sandbox: POST /developer/sandbox makes a developer org, a Test key and a quickstart template. GET reads it, DELETE closes it.Developer
AddedTry token: POST /developer/try-token returns a 15 minute pbtry_ bearer for the browser. DELETE ends them.Developer
AddedSandbox passes are previews: testPreview on pass detail, a TEST preview page as downloadUrl, SANDBOX_PREVIEW_ONLY (409) on .pkpass and SANDBOX_QUOTA (403) at a cap.General
Addedx-passbook-signature and x-passbook-timestamp are accepted beside x-wallet-*. GET /templates/{id}/input-schema is new.Templates
AddedPass imports report progress.skipped when a plan limit stops creates.Pass imports
AddedPOST /bundles/{id}/send-email takes Idempotency-Key.General
AddedScanner: list devices, read a pass's history, and read or delete its notes.Till API
ChangedBreakingPOST /roll-calls returns 201, not 200, when you send PassBook-Version: 2026-11-20. Without it nothing changes.Roll calls
ChangedSample events carry sample: true, so a test event is never mistaken for a real one.General
AddedList your sandbox Test calls from the last 7 days.Developer
AddedRead one logged Test call; bodies are kept for 24 hours.Developer
AddedYour sandbox key, its scopes and tier, and the calls of the last hour.Developer
ChangedReading an endpoint returns target: url or capture.Webhook endpoints
AddedList the requests a capture endpoint stored.Webhook endpoints
AddedRead one stored capture, with its headers and body.Webhook endpoints
ChangedUpdating an endpoint returns target: url or capture.Webhook endpoints
ChangedCreating an endpoint returns target: url or capture.Webhook endpoints
AddedReplay a stored capture to a URL and get the result.Webhook endpoints
AddedReveal the capture endpoint signing secret; audited.Webhook endpoints
ChangedThe test result returns captureId when the endpoint is a capture endpoint.Webhook endpoints
AddedCreate the org capture endpoint that stores what it receives.Webhook endpoints

2026-11-19

AddedEntitlements: a plan sets an organization's features and caps. A create at a cap answers FEATURE_LIMIT_REACHED (403) with feature, limit and used.General
AddedA feature the plan lacks answers FEATURE_NOT_INCLUDED (403); operations that need one carry x-feature.General

2026-10-31

AddedAPI keys: service, personal and platform tokens with scopes and live or test mode, sent as a bearer token.General
ChangedPass create with a key: templateVersion, releaseId and releaseGeneration are optional together. Send none and the server uses the approved release; with none it answers TEMPLATE_RELEASE_REQUIRED (409). Some but not all is 422.General
Changedmode on pass create defaults to the key's mode; a mismatch is MODE_MISMATCH (409).General
ChangedLists: a global key or a session without orgId gets ORG_REQUIRED (422). A session listing a forbidden org's passes gets 403, not an empty 200.General
ChangedUploaded templates start with a legacy release at their active version, so existing integrations keep creating passes. New versions need a candidate, a second reviewer and a release.General