Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/scoria02/marbes2021_backend/llms.txt

Use this file to discover all available pages before exploring further.

Marbes Backend is a production-ready REST API built with Express and TypeScript, backed by PostgreSQL. It powers the full operation of a financial lending company — from onboarding investors (aportantes) and credit clients, through contract and loan management, to bank reconciliation and regulatory reporting. All endpoints are secured with JWT authentication and scoped by role-based permissions.

Quickstart

Make your first authenticated API call in under 5 minutes

Authentication

Learn how to obtain and use JWT tokens to access protected endpoints

Financial Model

Understand TCOL, TPROD, contratos, and the fund lifecycle

API Reference

Full endpoint reference with request/response schemas

What Marbes Backend provides

The API is organized into six functional domains:

Business Operations

Manage investors (aportantes), credit clients, contracts, TCOL collections, and TPROD loans

Banking

Multi-bank support, BCV exchange rate sync, and inter-bank fund movement tracking

HR & Users

Employee management, role and permission assignment, and client document workflows

Accounting & Reports

Bank statement processing, balance queries, fund revaluation, and financial reporting

Credit Applications

Tokenized public credit application links and CIS PDF generation

Real-time

Socket.IO integration for live user presence and internal messaging

Getting started

1

Obtain a JWT token

Call POST /api/auth/login with your credentials. The response includes a token you’ll include in all subsequent requests as Authorization: Bearer <token>.
2

Explore the financial model

Read the Financial Model overview to understand how investors, contracts, collections (TCOL), and loans (TPROD) relate to each other.
3

Make your first API call

Follow the Quickstart to create your first investor record and verify the full request/response cycle.
4

Review the full API reference

Browse the API Reference tab to explore all endpoints grouped by domain, with full parameter and response documentation.

Base URL

All API endpoints are served under the base path:
http://your-server:7780
The server port defaults to 7780. A health check is available at GET /api/health and requires no authentication.

Build docs developers (and LLMs) love