Crear una Organización

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": "La Organización está completamente verificada y operativa."
  },
  "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": "La Organización está completamente verificada y operativa."
    },
    "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: 'La Organización está completamente verificada y operativa.'
    },
    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' => 'La Organización está completamente verificada y operativa.'
    ],
    '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\": \"La Organización está completamente verificada y operativa.\"\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\": \"La Organización está completamente verificada y operativa.\"\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\": \"La Organización está completamente verificada y operativa.\"\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

Crear una Organización

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": "La Organización está completamente verificada y operativa."
  },
  "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": "La Organización está completamente verificada y operativa."
    },
    "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: 'La Organización está completamente verificada y operativa.'
    },
    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' => 'La Organización está completamente verificada y operativa.'
    ],
    '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\": \"La Organización está completamente verificada y operativa.\"\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\": \"La Organización está completamente verificada y operativa.\"\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\": \"La Organización está completamente verificada y operativa.\"\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
}

Encabezados

Content-Type

string

El tipo de medio del recurso. El valor recomendado es application/json.

X-Request-Id

string<uuid>

Un identificador único utilizado para rastrear y seguir cada solicitud.

Authorization

string

Token JWT bearer para autenticación. Requerido cuando PLUGIN_AUTH_ENABLED=true (obligatorio en despliegues multiinquilino). Opcional en el modo OSS de inquilino único predeterminado. Formato: Bearer <token>

Cuerpo

application/json

legalName

string

requerido

La razón social de la Organización.

Maximum string length: 256

legalDocument

string

requerido

Identificación fiscal oficial, número de registro de la empresa u otra identificación legal.

Maximum string length: 256

Ejemplo:

"123456789012345"

parentOrganizationId

string<uuid> | null

El identificador único de la Organización matriz.

doingBusinessAs

string | null

El nombre comercial de la Organización.

Maximum string length: 256

status

object

Un objeto que contiene información sobre el estado. Importante: Si no se proporciona, el estado predeterminado será 'ACTIVE'.

Show child attributes

address

object

Un objeto que contiene información sobre la dirección de la Organización.

Show child attributes

metadata

object

Un objeto que contiene pares clave-valor para agregar como metadatos, donde el campo name es la clave y el campo value es el valor. Por ejemplo, para agregar un Centro de Costo, use 'costCenter': 'BR_11101997'.

Restricciones: las claves deben tener como máximo 100 caracteres; los valores de cadena de texto, como máximo 2000 caracteres. No se permiten objetos anidados (los valores deben ser cadena de texto, número o booleano), la estructura no puede exceder una profundidad máxima de 10, y se permite un máximo de 100 claves.

Show child attributes

Respuesta

Indica que el recurso fue creado exitosamente y la operación se completó como se esperaba.

string<uuid>

El identificador único de la Organización.

legalName

string

La razón social de la Organización.

Maximum string length: 256

parentOrganizationId

string<uuid> | null

El identificador único de la Organización matriz.

doingBusinessAs

string | null

El nombre comercial de la Organización.

Maximum string length: 256

legalDocument

string

Identificación fiscal oficial, número de registro de la empresa u otra identificación legal.

Maximum string length: 256

Ejemplo:

"123456789012345"

status

object

Un objeto que contiene información sobre el estado.

Show child attributes

address

object

Un objeto que contiene información sobre la dirección de la Organización.

Show child attributes

metadata

object

Show child attributes

createdAt

string<date-time>

Fecha y hora de creación (UTC).

updatedAt

string<date-time>

Fecha y hora de la última actualización (UTC).

deletedAt

string<date-time> | null

Fecha y hora de la eliminación lógica, si aplica (UTC).

Guía de inicio rápido

Listar Organizaciones

⌘I

Primeros pasos

API de Organizaciones

API de Ledgers

API de Activos

API de Tipos de Cuenta

API de Cuentas

API de Portafolios

API de Segmentos

API de Saldos

API de Transacciones

API de Operaciones

API de Rutas de Operación

API de Rutas de Transacción

API de Índices de Metadatos

API de Titulares

API de Instrumentos

API de Paquetes de Facturación

API de Paquetes

API de Cálculo de Facturación

API de Estimación

API de Cifrado

API de Protección

API de Tasas de Activos

Manejo de errores

Fees Engine

Crear una Organización

Encabezados

Cuerpo

Respuesta