Passmint
TemplatesDocsPricing
Log inGet started
Passmint
TemplatesDocsPricingTermsPrivacy

© 2026 Passmint. Built for indie makers.

← Docs

REST API · v1

API reference.

Base URL: https://passmint.com/api

01

Authentication

Pass your API key as a Bearer token. Test keys start with pmk_test_ and live keys with pmk_live_. The mode is determined by the prefix.

02

Idempotency

Send Idempotency-Key: <uuid> on POSTs. Replays within 24h return the cached response. Reusing a key with a different body returns 409.

03

Endpoints

POST
/v1/templates
Create a template
GET
/v1/templates
List templates
GET
/v1/templates/:id
Retrieve a template
PATCH
/v1/templates/:id
Update a template
DELETE
/v1/templates/:id
Archive a template
POST
/v1/passes
Issue a pass
GET
/v1/passes
List passes
GET
/v1/passes/:id
Retrieve a pass
DELETE
/v1/passes/:id
Void a pass
GET
/v1/passes/:id/events
List distribution events
GET
/v1/events
List recent events
04

Create a pass

05

Errors

curl https://passmint.com/api/v1/passes \
  -H "Authorization: Bearer pmk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "template_id": "tmpl_xxx",
    "holder_email": "alice@example.com",
    "holder_name": "Alice Johnson",
    "field_values": { "seatNumber": "A12" }
  }'
{
  "error": {
    "type": "invalid_request_error",
    "code": null,
    "message": "template_id is required",
    "param": "template_id"
  }
}
Authorization: Bearer pmk_test_xxx