API Reference

Welcome to the Simplistica API documentation. Our API provides programmatic access to all Simplistica features.

Base URL

• Production API server: https://simplistica.co

API Domains

• Documents

• Users

• Reviews

• Analysis

Authentication

All API endpoints require authentication using bearer tokens. Include your token in the Authorization header:

Authorization: Bearer YOUR_API_TOKEN

Authentication Flow

1. Generate API Key: Create a new API key in your team settings
2. Include in Requests: Add Authorization: Bearer YOUR_KEY header
3. Automatic Validation: Our system validates your key and permissions
4. Rate Limit Tracking: Usage is tracked per API key

Response Format

All API responses follow a consistent structure:

{
  "path": "/api/v1/endpoint",
  "version": "v1",
  "timestamp": "2025-01-27T10:30:00.000Z",
  "data": {...},
  "message": "Optional message"
}

Error Handling

Errors are returned with appropriate HTTP status codes and detailed messages:

{
  "path": "/api/v1/endpoint",
  "version": "v1",
  "timestamp": "2025-01-27T10:30:00.000Z",
  "error": "Validation Error",
  "message": "Field 'email' is required"
}

Rate Limits

• Free Tier: 100 requests per hour
• Pro Tier: 1,000 requests per hour
• Enterprise: Custom limits

Getting Started

1. Get your API key from your team settings
2. Make your first request using the examples in each endpoint section
3. Check the response format to understand the data structure
4. Handle errors gracefully by checking status codes and error messages

For more detailed information about specific endpoints, visit the individual API domain pages.