curl -s \
  "https://engine.example.com/v1/holders?limit=100" \
  -H "Authorization: Bearer $TOKEN"
# Send each page's next back as after, until null.

// A client from OpenAPI Generator: see Build a client.
import {
  Configuration,
  HoldersApi,
  ProblemFromJSON,
  ResponseError,
} from "./nodeasset-client";

const api = new HoldersApi(new Configuration({
  basePath: "https://engine.example.com",
  accessToken: process.env.TOKEN,
}));

try {
  // Send each page's next back as after, until null.
  let after: string | undefined;
  do {
    const page = await api.listHolders({ limit: 100, after });
    for (const holder of page.value ?? []) {
      console.log(holder);
    }
    after = page.next ?? undefined;
  } while (after);
} catch (e) {
  if (!(e instanceof ResponseError)) throw e;
  // A refusal is a problem; its type ends in the slug.
  const problem = ProblemFromJSON(await e.response.json());
  const slug = problem.type.split(":").pop();
  console.error(e.response.status, slug, problem.detail);
}

# A client from OpenAPI Generator: see Build a client.
import os
import sys

import nodeasset_client

config = nodeasset_client.Configuration(
    host="https://engine.example.com",
    access_token=os.environ["TOKEN"],
)
with nodeasset_client.ApiClient(config) as client:
    api = nodeasset_client.HoldersApi(client)
    try:
        # Send each page's next back as after, until null.
        after = None
        while True:
            page = api.list_holders(limit=100, after=after)
            for holder in page.value or []:
                print(holder)
            after = page.next
            if after is None:
                break
    except nodeasset_client.ApiException as e:
        # A refusal is a problem; its type ends in the slug.
        problem = nodeasset_client.Problem.from_json(e.body)
        slug = problem.type.rsplit(":", 1)[-1]
        print(e.status, slug, problem.detail, file=sys.stderr)

// A client from OpenAPI Generator: see Build a client.
import nodeasset.client.ApiClient;
import nodeasset.client.ApiException;
import nodeasset.client.api.HoldersApi;
import nodeasset.client.model.Problem;

public class ListHolders {
  public static void main(String[] args) throws Exception {
    ApiClient client = new ApiClient();
    client.updateBaseUri("https://engine.example.com");
    client.setRequestInterceptor(builder ->
        builder.header("Authorization", "Bearer " + System.getenv("TOKEN")));
    HoldersApi api = new HoldersApi(client);

    try {
      // Send each page's next back as after, until null.
      String after = null;
      do {
        var request = HoldersApi.APIListHoldersRequest.newBuilder()
            .limit(100)
            .after(after)
            .build();
        var page = api.listHolders(request);
        for (var holder : page.getValue()) {
          System.out.println(holder);
        }
        after = page.getNext();
      } while (after != null);
    } catch (ApiException e) {
      // A refusal is a problem; its type ends in the slug.
      Problem problem = client.getObjectMapper()
          .readValue(e.getResponseBody(), Problem.class);
      String type = problem.getType();
      String slug = type.substring(type.lastIndexOf(':') + 1);
      System.err.println(e.getCode() + " " + slug + " " + problem.getDetail());
    }
  }
}

{
  "offset": 669,
  "ledgerTime": "2026-10-03T13:26:05.457073Z",
  "now": "2026-10-03T13:26:06.069073884Z",
  "value": [
    {
      "holderId": "alpha",
      "party": "alpha::12207ae69b2ef2f1249abd41923a06ee30bffa9298a17b0a875355c441bf32045d73",
      "display": null,
      "externalRefs": {
        "clientId": "C-0042",
        "accountId": "110-234-567890"
      },
      "lei": "984500ALPHAEXAMPLE60",
      "createdAt": "2026-10-03T13:18:14.944056Z",
      "admissions": [
        {
          "party": "alpha::12207ae69b2ef2f1249abd41923a06ee30bffa9298a17b0a875355c441bf32045d73",
          "instrumentId": "FUND",
          "state": "admitted",
          "offerCid": null,
          "credentialCid": "004a34d41da1fd4ca207ba9a9681e360185a8574ac748f1c77c245b3d4f7b15bbeca12122074c9087f754562e712e4cc848d336bb035610d0cadbd2451cd4438db6d272330",
          "validUntil": null,
          "claims": [],
          "credentialIssuer": "venue::12207ae69b2ef2f1249abd41923a06ee30bffa9298a17b0a875355c441bf32045d73"
        }
      ],
      "holdings": null,
      "state": "active",
      "closedAt": null,
      "predecessorHolderId": null,
      "successorHolderId": null
    }
  ],
  "next": null
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}

{
  "type": "<string>",
  "title": "<string>",
  "status": 123,
  "detail": "<string>",
  "requestId": "<string>",
  "gate": "<string>",
  "check": "<string>",
  "recovery": "<string>",
  "retryAfter": 123,
  "retryable": true,
  "packageName": "<string>",
  "party": "<string>",
  "contractId": "<string>",
  "projectionOffset": 123,
  "ledgerEnd": 123,
  "code": 123,
  "reason": "<string>",
  "policyVersion": 123,
  "errors": [
    {
      "pointer": "<string>",
      "detail": "<string>"
    }
  ]
}