PKPASS Verification API

Verify an Apple Wallet .pkpass file for validity and compliance with Apple's specifications.

Verify PKPASS File

POST

/pkpass/verify

Required scope: pkpass:verify

Verify a .pkpass file for validity and compliance.

Request Parameters

Parameter	Type	Required	Description
`file`	file	Yes	The .pkpass file to verify (max 10MB)
`checkImages`	boolean	No	Validate image files (default: true)

Verification Details:

Signature Validation: Verifies the PKCS#7 signature against the manifest
Certificate Chain: Validates the certificate chain (signer → WWDR → Apple Root)
Manifest Verification: Checks SHA-1 hashes for all files
Compliance Check: Validates against Apple PassKit documentation
Image Validation: Checks image formats, dimensions, and variants (@2x, @3x)

curl -X POST https://api.walletwerk.eu/api/v1/pkpass/verify \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@pass.pkpass" \
  -F "checkImages=true"

const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('checkImages', 'true');

const response = await fetch('https://api.walletwerk.eu/api/v1/pkpass/verify', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: formData
});

const data = await response.json();

import requests

headers = {
    'Authorization': 'Bearer YOUR_API_KEY'
}

with open('pass.pkpass', 'rb') as f:
    files = {'file': f}
    data = {'checkImages': 'true'}
    
    response = requests.post(
        'https://api.walletwerk.eu/api/v1/pkpass/verify',
        headers=headers,
        files=files,
        data=data
    )

result = response.json()

You can test the PKPASS verification service using our demo tool. Upload a .pkpass file to see detailed validation results.