API Overview

The Passport API lets you programmatically access event data, builder profiles, stamps, and user information. It’s designed for builders who want to integrate Passport data into their own applications.

Requesting an API key

API access is granted per organization. To request a key:

Email hi@bastiankoh.com with:

Your name and organization
What you’re building and how you plan to use the API
Expected request volume

We’ll provision an API key and send it to you along with your rate limits.

Base URL

All API requests go to:


https://demo.stellarpassport.xyz/api/v1

Authentication

Include your API key in the Authorization header:


Authorization: Bearer your-api-key

See Authentication for details.

What you can access

The API provides read access to:

Builder profiles — Company info, stamps, categories
Events — Event details, participating companies
Public leaderboards — Top participants per event
Stamp data — Aggregate stamp collection statistics

Write operations (creating stamps, managing challenges) require admin-level API access.

Rate limits

Default rate limits are:

100 requests per minute for standard keys
Higher limits available on request

Rate limit headers are included in every response:


X-RateLimit-Limit: 100
X-RateLimit-Remaining: 97
X-RateLimit-Reset: 1714000000

Response format

All responses are JSON. Successful responses return a data field:


{
  "data": { ... }
}

Errors return an error field with a message:


{
  "error": "Not found"
}