Welcome to Lassoos ERP API

Lassoos is a powerful multi-tenant SaaS API that provides a robust set of endpoints for managing all aspects of enterprise operations with complete data isolation. Each company has its own secure environment for consultant management, work time tracking, expense reporting, leave management, and comprehensive dashboard analytics.

Multi-Tenant SaaS

Complete data isolation per company with secure multi-tenant architecture

Enterprise Security

JWT-based authentication with company-specific role-based access control

Company Management

Self-service company registration and comprehensive settings management

Interactive Documentation

Detailed API documentation with Swagger UI and real-time testing

API Endpoints

The API provides the following main endpoints for interacting with the system:

Company Registration

Self-service company registration allowing business owners to create their own isolated company environment with initial settings.

/api/v1/company/register

Authentication

Secure JWT-based authentication with multi-tenant context. Includes login, token refresh, and company-aware authorization.

/api/v1/auth

Company Settings

Comprehensive company configuration including work time policies, leave settings, and company profile management.

/api/v1/company/settings

Role Management

Company-specific role assignment and permission management for owners, admins, and users within each company.

/api/v1/company/roles

Consultants

Multi-tenant consultant management with company-isolated profiles, skills tracking, and availability management.

/api/v1/consultants

Work Time

Company-specific work time tracking with project allocation, client assignment, and configurable validation workflows.

/api/v1/work-time

Expenses

Multi-tenant expense management with company-specific categories, approval workflows, and reimbursement tracking.

/api/v1/expenses

Dashboard

Company-specific analytics and reporting with real-time business intelligence filtered by company context.

/api/v1/dashboard

Clients

Multi-tenant client management with company-isolated profiles, contact information, and project associations.

/api/v1/clients

Projects

Company-specific project management with client linking, work time allocation, and progress tracking.

/api/v1/projects

Business Trips

Company-isolated trip planning and tracking with expense integration and client visit management.

/api/v1/trips

Expense Categories

Company-specific expense categorization with hierarchical structure and receipt requirements configuration.

/api/v1/expense-categories

Leave Categories

Company-specific leave type management with paid/unpaid settings and approval workflow configuration.

/api/v1/leave-categories

Activities

Company-isolated activity management for work time tracking with customizable activity types and descriptions.

/api/v1/activities

Leave Management

Company-specific leave request management with approval workflows and balance tracking.

/api/v1/leaves

Ready to Get Started?

Explore our comprehensive API documentation to learn more about the available endpoints, request/response formats, and authentication requirements.

View API Documentation

Getting Started Guide

Follow these steps to get started with Lassoos ERP API:

  1. Company Registration: Create your company account using /api/v1/company/register with company details and owner information.
  2. Authentication: Login with your credentials to obtain a JWT token that includes your company context.
  3. Company Setup: Configure your company settings including work time policies, leave settings, and company profile.
  4. User Management: Invite team members and assign appropriate roles (Company Owner, Admin, or User).
  5. API Integration: Use the API endpoints to manage your company's operations with automatic data isolation.

Example Company Registration

POST /api/v1/company/register
Content-Type: application/json

{
  "company": {
    "name": "RAYE Consulting Solutions",
    "email": "contact@rayeconsulting.com",
    "address": "15 Avenue des Champs-Élysées, 75008 Paris"
  },
  "owner": {
    "email": "herve.raye@rayeconsulting.com",
    "password": "SecurePassword2024!",
    "firstName": "Hervé",
    "lastName": "RAYE",
    "phone": "+33 6 12 34 56 78"
  }
}

Authentication Example

Once your company is registered, authenticate to access the API with your company context:

Login Request

POST /api/v1/auth/login
Content-Type: application/json

{
  "email": "herve.raye@rayeconsulting.com",
  "password": "SecurePassword2024!"
}

// Response includes company context
{
  "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9...",
  "user": {
    "id": 1,
    "email": "herve.raye@rayeconsulting.com",
    "firstName": "Hervé",
    "lastName": "RAYE",
    "role": "COMPANY_OWNER"
  },
  "company": {
    "id": 1,
    "name": "RAYE Consulting Solutions"
  }
}