API Reference

Complete reference documentation for the LicenseSeat API.

Interactive API Docs — Explore our Interactive API Reference for a beautiful, interactive experience with request testing, full schemas, and live examples.

Quick Reference

Essentials

• Base URL: https://licenseseat.com/api/v1
• Auth: Bearer token in Authorization header
• Format: JSON request/response bodies
• Errors: Structured format with error.code and error.message

All license operations are product-scoped. The product slug and license key are in the URL path:

curl -X POST https://licenseseat.com/api/v1/products/my-app/licenses/XXXX-XXXX-XXXX-XXXX/validate \
  -H "Authorization: Bearer pk_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"device_id": "device-unique-id"}'

Response Format

All responses include an object field identifying the type:

{
  "object": "validation_result",
  "valid": true,
  "license": { ... },
  "activation": { ... }
}

Rate Limits

Rate limit headers included in all responses: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

Learn More

• Authentication — API key setup and security
• Error Codes — Complete error reference
• Interactive API Docs — Try requests in your browser