ReferenceAPI ReferenceRequest Journaling

Get journal entry

GET/system/requests/{id}●Retrieve a journal entry by its address or LUID.

Each journal entry contains the caller identity, target ledger, resource involved, action performed, and the full request and response payloads. Entries are signed by the ledger for authenticity verification.

GET
/system/requests/{id}

Usage Examples

curl -X GET "http://localhost:3000/v2/system/requests/<HANDLE>" \  -H "x-ledger: <YOUR LEDGER HANDLE>"
{
  "luid": "$req.-01xK0rStT2dS4wX3",
  "hash": "f1ce9ed7de04b389a6a2ae6aac7ec1ae7280795eebdfb060f98c3fc09fd02903",
  "data": {
    "handle": "F33aRjVTkwqZ6ybX6",
    "schema": "rest",
    "record": "wallet",
    "action": "create",
    "source": "signer:tesla-bank-admin",
    "target": "ledger:instant-payments",
    "params": {
      "method": "POST",
      "url": "https://ldg-dev.one/api/v2/wallets",
      "headers": {
        "content-type": "application/json",
        "x-ledger": "instant-payments",
        "Authorization": "[REDACTED]"
      },
      "body": "{\"hash\":\"0c91fa00006ddaf9476992370ba7209b4815f974d57fa1340e7b194afe37863b\",\"data\":{\"handle\":\"tesla-bank-wallet\",\"custom\":{\"name\":\"Tesla Bank Wallet\",\"description\":\"Primary wallet for Tesla Bank\"}},\"meta\":{\"proofs\":[{\"method\":\"ed25519-v2\",\"digest\":\"ae6506402682b12e805b1d75cf3997f18b41e5a24eb318fb223b7e5e39ca40ed\",\"public\":\"dsZvr0rEw9sIffHlv1VP65x1NB8GeXezIv6HONk1SIk=\",\"result\":\"0H17ehu2rXMaNKwqV7l2EDe1VGqJbOgCFCq+8D5tVsz1qp7D6TXjfNTatijNpFi7nLlYf+LhlqLLnVSm1aMVAA==\",\"custom\":{\"moment\":\"2025-04-05T14:30:00.000Z\",\"status\":\"created\"}}]}}",
      "moment": "2025-04-05T14:30:00.000Z"
    },
    "result": {
      "status": 201,
      "headers": {
        "content-type": "application/json; charset=utf-8"
      },
      "body": "{\"luid\":\"$wlt.-01xK9pStU3eT5xY4\",\"hash\":\"0c91fa00006ddaf9476992370ba7209b4815f974d57fa1340e7b194afe37863b\",\"data\":{\"handle\":\"tesla-bank-wallet\",\"custom\":{\"name\":\"Tesla Bank Wallet\",\"description\":\"Primary wallet for Tesla Bank\"}},\"meta\":{\"status\":\"created\",\"moment\":\"2025-04-05T14:30:00.050Z\",\"owners\":[\"dsZvr0rEw9sIffHlv1VP65x1NB8GeXezIv6HONk1SIk=\"],\"proofs\":[{\"signer\":\"tesla-bank-admin\",\"method\":\"ed25519-v2\",\"digest\":\"ae6506402682b12e805b1d75cf3997f18b41e5a24eb318fb223b7e5e39ca40ed\",\"public\":\"dsZvr0rEw9sIffHlv1VP65x1NB8GeXezIv6HONk1SIk=\",\"result\":\"0H17ehu2rXMaNKwqV7l2EDe1VGqJbOgCFCq+8D5tVsz1qp7D6TXjfNTatijNpFi7nLlYf+LhlqLLnVSm1aMVAA==\",\"custom\":{\"moment\":\"2025-04-05T14:30:00.000Z\",\"status\":\"created\"}},{\"signer\":\"system\",\"method\":\"ed25519-v2\",\"digest\":\"75545655dad3c6ac9a9e7552262de308ed18e7377d6d4fe273d2254c86a9e5a3\",\"public\":\"bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=\",\"result\":\"4NdQ4MSg7RoHtBEX8lUe9uxfNgfhcHLybvFyNLBzlJy7s78mBPxjCjErn7YQX4vxGdkm3zcpo+4bkJejO2oUDQ==\",\"custom\":{\"luid\":\"$wlt.-01xK9pStU3eT5xY4\",\"moment\":\"2025-04-05T14:30:00.050Z\",\"status\":\"created\"}}]}}",
      "moment": "2025-04-05T14:30:00.050Z"
    },
    "access": [
      {
        "action": "any"
      }
    ]
  },
  "meta": {
    "status": "created",
    "moment": "2025-04-05T14:30:00.060Z",
    "owners": [
      "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c="
    ],
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "b6ddf978144fa05e1c2b1b1b5c3eca7469d6eeb0cbe67f2ffaa232a629d09e2e",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "ZMkaGM4iM5pJ+bJmvsyu/OzuVUeVcYnqqez4yxb/E9sXFmZxHWWKF08jAzoXAUBGy075gFjK8Pn2r0RpK2smAA==",
        "custom": {
          "luid": "$req.-01xK0rStT2dS4wX3",
          "moment": "2025-04-05T14:30:00.060Z"
        }
      }
    ]
  }
}
{
  "hash": "b7eb7ccf5ffc126951e13e29a8dcfdaf95db859715d4edfc2d16f59a79d4cd58",
  "data": {
    "reason": "auth.unauthorized",
    "detail": "Invalid token."
  },
  "meta": {
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "3acece870c4118bfe4223118e4d2f3cfd5b8947a7093785b66d49aa57fa2890a",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "gnK63DqqWDY/UXvnZHixDKPKS6tfeGHgdARylnPiJLwQGyYxuD97TYbSg2wrzsf/bDrHwQYZaf8Gu5ryYP0UAA==",
        "custom": {
          "moment": "2025-04-05T14:30:00.000Z"
        }
      }
    ]
  }
}
{
  "hash": "9ec02726b50650add8acfd124c6defeb978a9ac252a5de888f9493ddc701e927",
  "data": {
    "reason": "auth.forbidden",
    "detail": "Request is not authorized"
  },
  "meta": {
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "4f8cbdc38d73348de0c31805c783c84a0fecc6be736d7e187004ba68cd00e675",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "P3hRnveehtuobb4AIO56XBmiduvmYJbpdmOHltG/IifBEH7QSWdv/0pqled4SO9x1Ne3oXuWxJy40DzMvx1MBA==",
        "custom": {
          "moment": "2025-04-05T14:30:00.000Z"
        }
      }
    ]
  }
}
{
  "hash": "d6c59a6df7165fa4a75159799ca5f5e26e544cbb8769eced3d35d8021f6f7935",
  "data": {
    "reason": "record.not-found",
    "detail": "Signer not found"
  },
  "meta": {
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "78cf86f34aefcf9da6ed4167a38aac0a2739f68f7bafb1d3e033c01ed1b6cdf1",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "9Ledk+/iAAtj+uLjGe2afq4kID7n8UQD6UpRpLBCujxFjxddq0uZ2tnYRTAXmYdHDkbF0uXqtNM9qO3xhEtpAA==",
        "custom": {
          "moment": "2025-04-05T14:30:00.000Z"
        }
      }
    ]
  }
}

{
  "hash": "1c084e8dcfb9bb84bc8ea96e9e137b149a34b2bbd85f8e60b4263f5aba980476",
  "data": {
    "custom": {
      "errors": [
        {
          "instancePath": "/handle",
          "schemaPath": "#/properties/handle/pattern",
          "keyword": "pattern",
          "params": {
            "pattern": "^[a-zA-Z0-9_\\-+.]+$"
          },
          "message": "must match pattern \"^[a-zA-Z0-9_\\-+.]+$\""
        }
      ]
    },
    "reason": "record.schema-invalid",
    "detail": "Schema validator error: data.handle must match pattern \"^[a-zA-Z0-9_\\-+.]+$\""
  },
  "meta": {
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "7a5febb431719b6f43d7e88e79211308e16ac651b71b339276373fdb4e7c3760",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "2/1zYw4AaIzsIHfOIC6V/CHw6owbjYHt48cwmFOig0ibeT0IbojLmj1RCRi8W00ka0udPa9WsacWDd7ObMY8CA==",
        "custom": {
          "moment": "2025-04-05T14:30:00.000Z"
        }
      }
    ]
  }
}

{
  "hash": "93a5f4d97a42c2df97f827c58ff7768d02568c15aca931e22b81fa3160ba0df3",
  "data": {
    "reason": "api.unexpected-error",
    "detail": "An unexpected error occurred"
  },
  "meta": {
    "proofs": [
      {
        "signer": "system",
        "method": "ed25519-v2",
        "digest": "efaf5360143b586917d9636779ad6e08571c5b06909a20dd0f5eba4bf3be7eae",
        "public": "bctQzN7mjMUNBIx4aSC8WYn03GJWoJjL/KrDb38oU5c=",
        "result": "hERh6Aecj59iR+Fb25OQsHJScOi4t8EiffKSfjlMQdjHMccTnfDlgZFdaJzXzUtpSwy/NHq0l+7ydh3HSWCoAg==",
        "custom": {
          "moment": "2025-04-05T14:30:00.000Z"
        }
      }
    ]
  }
}

Path Parameters

id*|

The unique identifier of the record - it is luid or handle (address).

Header Parameters

x-ledger?|

The unique identifier of ledger in context for multi tenant requests.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

List journal entries GET

Use this endpoint to debug failed operations, audit which signers performed specific actions, track bridge activity, or verify compliance by reviewing the full request and response history for a participant or record. Supported filters: - `data.source` — caller identity (e.g., `signer:admin` or `bridge:my-bridge`) - `data.target` — target ledger (e.g., `ledger:my-ledger`) - `data.record` — resource involved (e.g., `wallet:my-wallet`) - `data.action` — action performed (e.g., `create`, `update`, `drop`) - `meta.status` — record status - `meta.labels` — record labels

CLI Reference

Next Page