curl -s \
  "https://engine.example.com/v1/dealing-cycles/cy-0001" \
  -H "Authorization: Bearer $TOKEN"

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

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

try {
  const answer = await api.getDealingCycle({ dealingCycleId: "cy-0001" });
  console.log(answer.value);
} 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.DealingCyclesApi(client)
    try:
        answer = api.get_dealing_cycle(dealing_cycle_id="cy-0001")
        print(answer.value)
    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.DealingCyclesApi;
import nodeasset.client.model.Problem;

public class GetDealingCycle {
  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")));
    DealingCyclesApi api = new DealingCyclesApi(client);

    try {
      var request = DealingCyclesApi.APIGetDealingCycleRequest.newBuilder()
          .dealingCycleId("cy-0001")
          .build();
      var answer = api.getDealingCycle(request);
      System.out.println(answer.getValue());
    } 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.688373Z",
  "now": "2026-10-03T13:26:06.300373309Z",
  "value": {
    "dealingCycleId": "cy-0001",
    "instrumentId": "FUND",
    "payment": {
      "admin": "bank::12207ae69b2ef2f1249abd41923a06ee30bffa9298a17b0a875355c441bf32045d73",
      "id": "TD"
    },
    "strike": 1.004,
    "deadline": "2026-10-04T01:25:01.008743Z",
    "intentCid": "00f71c57fbae36e795ea0e2011183751b5fa0386db85af71582fb3983fd9fc65b6ca121220f3cdc69dbe07314db9676a5c799439981ffb269b277497b596938d6c98ca0733",
    "state": "awaiting-allocations",
    "orders": [
      {
        "kind": "subscription",
        "id": "lot-alpha-0004",
        "holderId": "alpha",
        "party": "alpha::12207ae69b2ef2f1249abd41923a06ee30bffa9298a17b0a875355c441bf32045d73",
        "units": 100,
        "amount": 100.4,
        "allocated": [
          "fund",
          "payment"
        ],
        "paymentLeg": {
          "legId": "lot-alpha-0004-payment",
          "from": "alpha::12207ae69b2ef2f1249abd41923a06ee30bffa9298a17b0a875355c441bf32045d73",
          "to": "treasury::12207ae69b2ef2f1249abd41923a06ee30bffa9298a17b0a875355c441bf32045d73",
          "amount": 100.4,
          "allocationCid": "00d4b6f8a0c2e4f6a8b0c2d4e6f8a0b2c4d6e8f0a2b4c6d8e0f2a4b6c8d0e2f4a6ca1212205b7d9f1a3c5e7b9d2f4a6c8e0b1d3f5a7c9e2b4d6f8a0c3e5b7d9f1a2c4e6b8",
          "allocated": true
        },
        "lastFailure": null
      },
      {
        "kind": "redemption",
        "id": "red-beta-0002",
        "holderId": "beta",
        "party": "beta::12207ae69b2ef2f1249abd41923a06ee30bffa9298a17b0a875355c441bf32045d73",
        "units": 60,
        "amount": 60.24,
        "allocated": [],
        "paymentLeg": {
          "legId": "red-beta-0002-payment",
          "from": "treasury::12207ae69b2ef2f1249abd41923a06ee30bffa9298a17b0a875355c441bf32045d73",
          "to": "beta::12207ae69b2ef2f1249abd41923a06ee30bffa9298a17b0a875355c441bf32045d73",
          "amount": 60.24,
          "allocationCid": null,
          "allocated": false
        },
        "lastFailure": {
          "type": "urn:nodeasset:problem:in-dealing-cycle",
          "check": null,
          "detail": "redemption 'red-beta-0002' is in dealing cycle 'cy-0001': it settles with the cycle, not alone",
          "operationId": "op-3c1e5a7b-9d2f-4b6a-8c0e-2d4f6a8b0c1e",
          "failedAt": "2026-10-03T13:25:41.207815Z"
        }
      }
    ],
    "paidIn": 100.4,
    "paidOut": 60.24,
    "net": 40.16,
    "endedAt": null,
    "endedUpdateId": null,
    "lastFailure": 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>"
    }
  ]
}

{
  "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>"
    }
  ]
}