API Setup

Overview

This document covers how to obtain and configure API credentials for Lucra's server-to-server integration.

Obtaining API Keys

API keys are provided directly by the Lucra team. Contact your Lucra representative to receive credentials for each environment.

Environments

Lucra operates two distinct environments:

Environment	Base URL
Sandbox	https://api.sandbox.lucrasports.com
Production	https://api.lucrasports.com

Note: Use sandbox for development and testing. Production credentials are separate and should only be used in live environments.

Authentication

All API requests require authentication via an API key. The recommended method is to pass the API key in the X-Lucra-Api-Key header.

Request Format

curl https://<base-url>/api/rest/<endpoint> \
  -H "X-Lucra-Api-Key: <your-api-key>"

Example Request

curl https://api.sandbox.lucrasports.com/api/rest/some-endpoint \
  -H "X-Lucra-Api-Key: your_sandbox_key"

Best Practices

• Store keys securely: Use environment variables or secret management systems

• Separate keys per environment: Never use production keys in sandbox

• Rotate keys periodically: Contact Lucra team if you suspect key compromise

• Monitor rate limits: Contact Lucra team for rate limit information

Next Steps

Once you have API credentials configured:

• Set up Webhook Subscriptions to receive event notifications

• Integrate product-specific APIs:

  • Games You Play REST API

  • Tournaments REST API

  • Free-to-Play REST API