Dukalink API

Welcome to the Dukalink Point of Sale (POS) API. This API provides endpoints for managing a multi-tenant POS system.

API Features

• Multi-tenant architecture
• User authentication and authorization
• Branch management
• Product management
• Stock management
• DSA (Direct Sales Agent) management
• MPESA transaction handling
• POS session management

API Documentation

Comprehensive API documentation is available through Swagger UI. You can explore all available endpoints, request/response formats, and authentication requirements.

Recommendation: When accessing over network (using IP address), use the "Network-Friendly" version. If one version doesn't work, try another one.

Authentication

Most API endpoints require authentication using JWT Bearer tokens. To authenticate:

1. Obtain a token by sending a POST request to /api/v1/auth/login with valid credentials
2. Include the token in the Authorization header of subsequent requests: Authorization: Bearer <your-token>

Default Users

The following users are available for testing:

• Super Admin: admin@example.com / admin123
• Branch Admin: branch@example.com / branch123
• POS Operator: operator@example.com / operator123

Health Check

You can check if the API is running by accessing the health check endpoint:

Check API Health