API Reference
Complete API documentation with examples, interactive testing, and detailed response schemas.
API Overview
Base URL
api.licensechain.app/v1 Authentication
All API requests require authentication using your API key.
Authorization Bearer your-api-key Rate Limits
API requests are rate limited to ensure fair usage.
- 1000 requests per hour
- 100 requests per minute
- Burst limit: 10 requests per second
API Endpoints
POST /v1/licenses/verify
Verify a license key (public endpoint, no authentication required).
Verification Types: The response includes a verificationType field indicating the verification level:
basic (Free tier), advanced (Pro tier), or enterprise (Business/Enterprise tier with custom rules).
Request:
{
"key": "LC-XXXXXX-XXXXXX-XXXXXX"
}Response:
{
"valid": true,
"status": "ACTIVE",
"expiresAt": "2025-12-31T23:59:59Z",
"email": "user@example.com",
"verificationType": "enterprise",
"metadata": {
"ipAddress": "192.168.1.1",
"userAgent": "Mozilla/5.0...",
"verifiedAt": "2024-01-01T00:00:00.000Z",
"advancedChecks": true
}
}GET /v1/licenses/:id
Get license details by ID or license key.
Requires: Authentication
Response:
{
"id": "license_id",
"appId": "app_id",
"key": "LC-XXXXXX-XXXXXX-XXXXXX",
"licenseKey": "LC-XXXXXX-XXXXXX-XXXXXX",
"plan": "PRO",
"status": "ACTIVE",
"issuedTo": "John Doe",
"issuedEmail": "user@example.com",
"email": "user@example.com",
"expiresAt": "2025-12-31T23:59:59Z",
"createdAt": "2024-01-01T00:00:00.000Z",
"updatedAt": "2024-01-01T00:00:00.000Z"
}GET /v1/apps/:appId/licenses
List all licenses for an application.
Requires: Authentication
POST /v1/apps/:appId/licenses
Create a new license.
Requires: Authentication
Request:
{
"appId": "app_id",
"plan": "PRO",
"issuedTo": "John Doe",
"issuedEmail": "user@example.com",
"expiresAt": "2025-12-31T23:59:59Z"
}PATCH /v1/licenses/:id
Update a license.
Requires: Authentication
DELETE /v1/licenses/:id
Delete a license.
Requires: Authentication
GET /v1/apps
List all applications.
Requires: Authentication
POST /v1/apps
Create a new application.
Requires: Authentication
GET /v1/webhooks
List all webhooks.
Requires: Authentication
POST /v1/webhooks
Create a webhook.
Requires: Authentication
GET /v1/analytics/stats
Get analytics statistics.
Requires: Authentication
GET /v1/analytics/licenses
Get license analytics.
Requires: Authentication