Create an Organization

curl --request POST \
  --url https://ledger.sandbox.lerian.net/v1/organizations \
  --header 'Content-Type: application/json' \
  --data '
{
  "legalName": "Lerian Studio",
  "doingBusinessAs": "Lerian Studio",
  "legalDocument": "123456789",
  "status": {
    "code": "ACTIVE",
    "description": "Organization is fully verified and operational."
  },
  "address": {
    "line1": "Avenida Paulista, 1234 - Centro",
    "line2": "CJ 123",
    "zipCode": "04696040",
    "city": "São Paulo",
    "state": "SP",
    "country": "BR"
  },
  "metadata": {
    "segment": "fintech",
    "riskTier": "low",
    "registrationSource": "onboarding-portal"
  }
}
'

import requests

url = "https://ledger.sandbox.lerian.net/v1/organizations"

payload = {
    "legalName": "Lerian Studio",
    "doingBusinessAs": "Lerian Studio",
    "legalDocument": "123456789",
    "status": {
        "code": "ACTIVE",
        "description": "Organization is fully verified and operational."
    },
    "address": {
        "line1": "Avenida Paulista, 1234 - Centro",
        "line2": "CJ 123",
        "zipCode": "04696040",
        "city": "São Paulo",
        "state": "SP",
        "country": "BR"
    },
    "metadata": {
        "segment": "fintech",
        "riskTier": "low",
        "registrationSource": "onboarding-portal"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    legalName: 'Lerian Studio',
    doingBusinessAs: 'Lerian Studio',
    legalDocument: '123456789',
    status: {code: 'ACTIVE', description: 'Organization is fully verified and operational.'},
    address: {
      line1: 'Avenida Paulista, 1234 - Centro',
      line2: 'CJ 123',
      zipCode: '04696040',
      city: 'São Paulo',
      state: 'SP',
      country: 'BR'
    },
    metadata: {segment: 'fintech', riskTier: 'low', registrationSource: 'onboarding-portal'}
  })
};

fetch('https://ledger.sandbox.lerian.net/v1/organizations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ledger.sandbox.lerian.net/v1/organizations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'legalName' => 'Lerian Studio',
    'doingBusinessAs' => 'Lerian Studio',
    'legalDocument' => '123456789',
    'status' => [
        'code' => 'ACTIVE',
        'description' => 'Organization is fully verified and operational.'
    ],
    'address' => [
        'line1' => 'Avenida Paulista, 1234 - Centro',
        'line2' => 'CJ 123',
        'zipCode' => '04696040',
        'city' => 'São Paulo',
        'state' => 'SP',
        'country' => 'BR'
    ],
    'metadata' => [
        'segment' => 'fintech',
        'riskTier' => 'low',
        'registrationSource' => 'onboarding-portal'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://ledger.sandbox.lerian.net/v1/organizations"

	payload := strings.NewReader("{\n  \"legalName\": \"Lerian Studio\",\n  \"doingBusinessAs\": \"Lerian Studio\",\n  \"legalDocument\": \"123456789\",\n  \"status\": {\n    \"code\": \"ACTIVE\",\n    \"description\": \"Organization is fully verified and operational.\"\n  },\n  \"address\": {\n    \"line1\": \"Avenida Paulista, 1234 - Centro\",\n    \"line2\": \"CJ 123\",\n    \"zipCode\": \"04696040\",\n    \"city\": \"São Paulo\",\n    \"state\": \"SP\",\n    \"country\": \"BR\"\n  },\n  \"metadata\": {\n    \"segment\": \"fintech\",\n    \"riskTier\": \"low\",\n    \"registrationSource\": \"onboarding-portal\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://ledger.sandbox.lerian.net/v1/organizations")
  .header("Content-Type", "application/json")
  .body("{\n  \"legalName\": \"Lerian Studio\",\n  \"doingBusinessAs\": \"Lerian Studio\",\n  \"legalDocument\": \"123456789\",\n  \"status\": {\n    \"code\": \"ACTIVE\",\n    \"description\": \"Organization is fully verified and operational.\"\n  },\n  \"address\": {\n    \"line1\": \"Avenida Paulista, 1234 - Centro\",\n    \"line2\": \"CJ 123\",\n    \"zipCode\": \"04696040\",\n    \"city\": \"São Paulo\",\n    \"state\": \"SP\",\n    \"country\": \"BR\"\n  },\n  \"metadata\": {\n    \"segment\": \"fintech\",\n    \"riskTier\": \"low\",\n    \"registrationSource\": \"onboarding-portal\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ledger.sandbox.lerian.net/v1/organizations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"legalName\": \"Lerian Studio\",\n  \"doingBusinessAs\": \"Lerian Studio\",\n  \"legalDocument\": \"123456789\",\n  \"status\": {\n    \"code\": \"ACTIVE\",\n    \"description\": \"Organization is fully verified and operational.\"\n  },\n  \"address\": {\n    \"line1\": \"Avenida Paulista, 1234 - Centro\",\n    \"line2\": \"CJ 123\",\n    \"zipCode\": \"04696040\",\n    \"city\": \"São Paulo\",\n    \"state\": \"SP\",\n    \"country\": \"BR\"\n  },\n  \"metadata\": {\n    \"segment\": \"fintech\",\n    \"riskTier\": \"low\",\n    \"registrationSource\": \"onboarding-portal\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "019c96a0-0a98-7287-9a31-786e0809c769",
  "parentOrganizationId": null,
  "legalName": "Lerian Studio",
  "doingBusinessAs": "Lerian Studio",
  "legalDocument": "123456789",
  "address": {
    "line1": "Avenida Paulista, 1234 - Centro",
    "line2": "CJ 123",
    "zipCode": "04696040",
    "city": "São Paulo",
    "state": "SP",
    "country": "BR"
  },
  "status": {
    "code": "ACTIVE",
    "description": "ACTIVE"
  },
  "createdAt": "2026-02-25T21:06:36.824Z",
  "updatedAt": "2026-02-25T21:06:36.824Z",
  "deletedAt": null
}

POST

organizations

Create an Organization

curl --request POST \
  --url https://ledger.sandbox.lerian.net/v1/organizations \
  --header 'Content-Type: application/json' \
  --data '
{
  "legalName": "Lerian Studio",
  "doingBusinessAs": "Lerian Studio",
  "legalDocument": "123456789",
  "status": {
    "code": "ACTIVE",
    "description": "Organization is fully verified and operational."
  },
  "address": {
    "line1": "Avenida Paulista, 1234 - Centro",
    "line2": "CJ 123",
    "zipCode": "04696040",
    "city": "São Paulo",
    "state": "SP",
    "country": "BR"
  },
  "metadata": {
    "segment": "fintech",
    "riskTier": "low",
    "registrationSource": "onboarding-portal"
  }
}
'

import requests

url = "https://ledger.sandbox.lerian.net/v1/organizations"

payload = {
    "legalName": "Lerian Studio",
    "doingBusinessAs": "Lerian Studio",
    "legalDocument": "123456789",
    "status": {
        "code": "ACTIVE",
        "description": "Organization is fully verified and operational."
    },
    "address": {
        "line1": "Avenida Paulista, 1234 - Centro",
        "line2": "CJ 123",
        "zipCode": "04696040",
        "city": "São Paulo",
        "state": "SP",
        "country": "BR"
    },
    "metadata": {
        "segment": "fintech",
        "riskTier": "low",
        "registrationSource": "onboarding-portal"
    }
}
headers = {"Content-Type": "application/json"}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'Content-Type': 'application/json'},
  body: JSON.stringify({
    legalName: 'Lerian Studio',
    doingBusinessAs: 'Lerian Studio',
    legalDocument: '123456789',
    status: {code: 'ACTIVE', description: 'Organization is fully verified and operational.'},
    address: {
      line1: 'Avenida Paulista, 1234 - Centro',
      line2: 'CJ 123',
      zipCode: '04696040',
      city: 'São Paulo',
      state: 'SP',
      country: 'BR'
    },
    metadata: {segment: 'fintech', riskTier: 'low', registrationSource: 'onboarding-portal'}
  })
};

fetch('https://ledger.sandbox.lerian.net/v1/organizations', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://ledger.sandbox.lerian.net/v1/organizations",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'legalName' => 'Lerian Studio',
    'doingBusinessAs' => 'Lerian Studio',
    'legalDocument' => '123456789',
    'status' => [
        'code' => 'ACTIVE',
        'description' => 'Organization is fully verified and operational.'
    ],
    'address' => [
        'line1' => 'Avenida Paulista, 1234 - Centro',
        'line2' => 'CJ 123',
        'zipCode' => '04696040',
        'city' => 'São Paulo',
        'state' => 'SP',
        'country' => 'BR'
    ],
    'metadata' => [
        'segment' => 'fintech',
        'riskTier' => 'low',
        'registrationSource' => 'onboarding-portal'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://ledger.sandbox.lerian.net/v1/organizations"

	payload := strings.NewReader("{\n  \"legalName\": \"Lerian Studio\",\n  \"doingBusinessAs\": \"Lerian Studio\",\n  \"legalDocument\": \"123456789\",\n  \"status\": {\n    \"code\": \"ACTIVE\",\n    \"description\": \"Organization is fully verified and operational.\"\n  },\n  \"address\": {\n    \"line1\": \"Avenida Paulista, 1234 - Centro\",\n    \"line2\": \"CJ 123\",\n    \"zipCode\": \"04696040\",\n    \"city\": \"São Paulo\",\n    \"state\": \"SP\",\n    \"country\": \"BR\"\n  },\n  \"metadata\": {\n    \"segment\": \"fintech\",\n    \"riskTier\": \"low\",\n    \"registrationSource\": \"onboarding-portal\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://ledger.sandbox.lerian.net/v1/organizations")
  .header("Content-Type", "application/json")
  .body("{\n  \"legalName\": \"Lerian Studio\",\n  \"doingBusinessAs\": \"Lerian Studio\",\n  \"legalDocument\": \"123456789\",\n  \"status\": {\n    \"code\": \"ACTIVE\",\n    \"description\": \"Organization is fully verified and operational.\"\n  },\n  \"address\": {\n    \"line1\": \"Avenida Paulista, 1234 - Centro\",\n    \"line2\": \"CJ 123\",\n    \"zipCode\": \"04696040\",\n    \"city\": \"São Paulo\",\n    \"state\": \"SP\",\n    \"country\": \"BR\"\n  },\n  \"metadata\": {\n    \"segment\": \"fintech\",\n    \"riskTier\": \"low\",\n    \"registrationSource\": \"onboarding-portal\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://ledger.sandbox.lerian.net/v1/organizations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n  \"legalName\": \"Lerian Studio\",\n  \"doingBusinessAs\": \"Lerian Studio\",\n  \"legalDocument\": \"123456789\",\n  \"status\": {\n    \"code\": \"ACTIVE\",\n    \"description\": \"Organization is fully verified and operational.\"\n  },\n  \"address\": {\n    \"line1\": \"Avenida Paulista, 1234 - Centro\",\n    \"line2\": \"CJ 123\",\n    \"zipCode\": \"04696040\",\n    \"city\": \"São Paulo\",\n    \"state\": \"SP\",\n    \"country\": \"BR\"\n  },\n  \"metadata\": {\n    \"segment\": \"fintech\",\n    \"riskTier\": \"low\",\n    \"registrationSource\": \"onboarding-portal\"\n  }\n}"

response = http.request(request)
puts response.read_body

{
  "id": "019c96a0-0a98-7287-9a31-786e0809c769",
  "parentOrganizationId": null,
  "legalName": "Lerian Studio",
  "doingBusinessAs": "Lerian Studio",
  "legalDocument": "123456789",
  "address": {
    "line1": "Avenida Paulista, 1234 - Centro",
    "line2": "CJ 123",
    "zipCode": "04696040",
    "city": "São Paulo",
    "state": "SP",
    "country": "BR"
  },
  "status": {
    "code": "ACTIVE",
    "description": "ACTIVE"
  },
  "createdAt": "2026-02-25T21:06:36.824Z",
  "updatedAt": "2026-02-25T21:06:36.824Z",
  "deletedAt": null
}

Headers

Content-Type

string

The type of media of the resource. Recommended value is application/json.

X-Request-Id

string<uuid>

A unique identifier used to trace and track each request.

Authorization

string

Bearer JWT token for authentication. Required when PLUGIN_AUTH_ENABLED=true (enforced in multi-tenant deployments). Optional in default OSS single-tenant mode. Format: Bearer <token>

Body

application/json

legalName

string

required

The legal name of the Organization.

Maximum string length: 256

legalDocument

string

required

Official tax ID, company registration number, or other legal identification.

Maximum string length: 256

Example:

"123456789012345"

parentOrganizationId

string<uuid> | null

The unique identifier of the parent Organization.

doingBusinessAs

string | null

The trade name of the Organization.

Maximum string length: 256

status

object

An object containing information about the status. Important: If not provided, the default status will be 'ACTIVE'.

Show child attributes

address

object

An object containing information about the address of the Organization.

Show child attributes

metadata

object

An object containing key-value pairs to add as metadata, where the field name is the key and the field value is the value. For example, to add a Cost Center, use 'costCenter': 'BR_11101997'.

Constraints: keys must be at most 100 characters; string values at most 2000 characters. Nested objects are not allowed (values must be string, number, or boolean), the structure may not exceed a maximum depth of 10, and a maximum of 100 keys is permitted.

Show child attributes

Response

Indicates that the resource was successfully created and the operation was completed as expected.

string<uuid>

The unique identifier of the Organization.

legalName

string

The legal name of the Organization.

Maximum string length: 256

parentOrganizationId

string<uuid> | null

The unique identifier of the parent Organization.

doingBusinessAs

string | null

The trade name of the Organization.

Maximum string length: 256

legalDocument

string

Official tax ID, company registration number, or other legal identification.

Maximum string length: 256

Example:

"123456789012345"

status

object

An object containing information about the status.

Show child attributes

address

object

An object containing information about the address of the Organization.

Show child attributes

metadata

object

An object containing key-value pairs to add as metadata, where the field name is the key and the field value is the value. For example, to add a Cost Center, use 'costCenter': 'BR_11101997'.

Show child attributes

createdAt

string<date-time>

Timestamp of creation (UTC).

updatedAt

string<date-time>

Timestamp of last update (UTC).

deletedAt

string<date-time> | null

Timestamp of soft deletion, if applicable (UTC).

Quick start guide

List Organizations

Getting started

Organizations API

Ledgers API

Assets API

Account Types API

Accounts API

Portfolios API

Segments API

Balances API

Transactions API

Operations API

Operation Routes API

Transaction Routes API

Metadata Indexes API

Holders API

Instruments API

Billing Packages API

Packages API

Billing Calculation API

Estimation API

Encryption API

Protection API

Asset Rates API

Error handling

Fees Engine

Create an Organization

Headers

Body

Response