Welcome to Temple

Public API for Temple Digital Group.

Getting Started

Base URLs:

• Testnet: https://api-testnet.templedigitalgroup.com

Prerequisites: You need a Temple account to access the API. Sign up here.

Authentication

The API supports two authentication methods. Every authenticated endpoint accepts either method.

API Key (Recommended)

API keys are the primary and recommended way to authenticate with the API. Include your API key in the X-API-Key header:

X-API-Key: your-api-key

API keys are long-lived and do not expire unless revoked. They are ideal for server-to-server integrations.

JWT Bearer Token (Alternative)

JWT tokens are accepted as an alternative authentication method:

1. Obtain a token by calling POST /auth/login with your Temple account email and password
2. Include the token in the Authorization header:

   Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...

3. Access tokens expire after 30 minutes. Use POST /auth/refresh to get a new token pair.

When both an X-API-Key header and a JWT Authorization header are present, the API key takes precedence.

Rate Limiting: Requests are rate-limited per key (API key) or per user (JWT). Exceeding the limit returns HTTP 429.