API Reference

Quick Start Guide

Starting with Midaz is straightforward. Follow these steps to build your foundation and explore the possibilities.


Step 1 - Set Up Your Environment

To set up your environment, you must first set up Midaz and then set up the Midaz Console.

  • Alternatively, you can set up Midaz All-in-One , a unified platform that seamlessly integrates Midaz Ledger and Midaz Console.

Step 2 - Authenticate (optional)

Starting from Midaz v1.49, authentication is no longer required in the Community version. You can make requests to the Midaz APIs directly.

Soon, you will be able to use our Auth & Identity plugin to add the authentication features to your environment. For more information, contact a Sales Representative.

📘

Older versions

If you are using an older version of Midaz, access our authentication documentation.


Step 3 - Create Your Midaz Structure

Start by creating the data structure that powers your workflows.


Step 3.1 - Create an Organization

The first step is to create your Organization within Midaz.

👍

Organizational Structure

If your organization has multiple branches, you can create various Organizations and designate a "Parent Organization."

For example, if Company XYZ has branches in New York and Brazil, you can create an Organization for Company XYZ and set it as the parent of XYZ New York and XYZ Brazil.


For a complete list of endpoints to manage your Organization, expand the section below:

Managing Organizations

Step 3.2 - Create a Ledger

Each organization must have at least on Ledger. However, you can have multiple Ledgers within each Organization if needed.

For a complete list of endpoints to manage your Ledger, expand the section below:

Managing Ledgers
  • Retrieve all Ledgers using the List Ledgers endpoint.
  • Retrieve a specific Ledger with the Retrieve a Ledger endpoint.
  • Update Ledger details using the Update a Ledger endpoint.
  • Delete a Ledger in Homologation using the Delete a Ledger endpoint.
    • For Ledgers in Production, deletion requires contacting Lerian support for security purposes.

Step 3.3 - Create the Assets

Your Organization can have multiple Assets. However, each Asset must be created individually, allowing for specific configurations like decimal places.

👍

External Account

When you create an Asset, Midaz automatically sets up an External Account if one doesn’t already exist. This ensures seamless backing for all transactions flowing in and out of the Ledger.

For a complete list of endpoints to manage your Assets, expand the section below:

Managing Assets

Step 3.4 - Create a Segment (optional)

If you want, you can use the Segment ID as a custom grouping label that enables clustering accounts according to user-defined policies, supporting efficient account segmentation and management.

For a complete list of endpoints to manage your Segment, expand the section below:

Managing Segment

Step 3.5 - Create a Portfolio

Create a Portfolio to group your accounts of different Assets.

For a complete list of endpoints to manage your Portfolios, expand the section below:

Managing Portfolios

Step 3.6 - Create the Accounts

You can now add the accounts related to the Assets you want to use with the Ledger. You will have to create one account for each Asset.

For a complete list of endpoints to manage your Accounts, expand the section below:

Managing Accounts

Step 4 - Explore Our APIs

Dive into the API reference to learn more about how Midaz can elevate your operations. From metadata handling to idempotency, every detail is crafted for simplicity and efficiency.


Need Help?

You're not alone. We’re here to support you every step of the way.