Saltar al contenido principal
GET
/
v1
/
organizations
/
{organization_id}
/
holders
Listar titulares
curl --request GET \
  --url https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/holders
import requests

url = "https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/holders"

response = requests.get(url)

print(response.text)
const options = {method: 'GET'};

fetch('https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/holders', 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/{organization_id}/holders",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);

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

curl_close($curl);

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

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

func main() {

url := "https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/holders"

req, _ := http.NewRequest("GET", url, nil)

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

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

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.get("https://ledger.sandbox.lerian.net/v1/organizations/{organization_id}/holders")
.asString();
require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body
{
  "items": "<unknown>",
  "limit": 123,
  "next_cursor": "<string>",
  "page": 123,
  "prev_cursor": "<string>"
}
{
"code": "<string>",
"detail": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "<string>",
"status": 123,
"title": "<string>",
"type": "about:blank"
}

Encabezados

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>

Parámetros de ruta

organization_id
string<uuid>
requerido

El identificador único de la Organización asociada al Ledger.

Parámetros de consulta

metadata
string

JSON string to filter holders by metadata fields Cadena JSON para filtrar titulares por campos de metadatos

limit
string

Max items per page (1-100, default 10) Máximo de elementos por página (1-100, predeterminado 10)

page
string

Page number (default 1) Número de página (predeterminado 1)

sort_order
string

Sort direction (asc, desc) Dirección de ordenamiento (asc, desc)

include_deleted
string

Return includes logically deleted holders (true,false) La respuesta incluye los titulares eliminados lógicamente (true,false)

external_id
string

Filter holders by externalID Filtra los titulares por externalID

document
string

Filter holders by document Filtra los titulares por documento

Respuesta

OK

items
any
requerido
limit
integer<int64>
requerido
Ejemplo:

10

next_cursor
string
Ejemplo:

"eyJpZCI6IjAxOTI..."

page
integer<int64>
Ejemplo:

1

prev_cursor
string
Ejemplo:

"eyJpZCI6IjAxOTE..."