> ## Documentation Index
> Fetch the complete documentation index at: https://developer.bron.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Canton Ledger API passthrough

> Forwards a whitelisted Canton JSON Ledger API request on behalf of a wallet connected via WalletConnect. This route only proxies a read-only set of requests after validating ownership of the calling parties.

<sup>API Key permissions: Transaction Operator, Full Access</sup>



## OpenAPI

````yaml /bron-open-api-public.json post /workspaces/{workspaceId}/canton/ledger-query
openapi: 3.1.1
info:
  description: >-
    Bron API is based on the RESTish interface provided for data exchange
    between a client and a server with the use of HTTPS requests and responses.
  title: Bron API
  version: latest
  x-bron-formats:
    bigint: Arbitrary-precision integer encoded as a JSON string.
    date-time-millis: >-
      Epoch milliseconds (UTC) encoded as a JSON string. Convert with `new
      Date(parseInt(value))` or equivalent.
    decimal: Arbitrary-precision decimal encoded as a JSON string.
    int32: 32-bit integer encoded as a JSON string.
    int64: >-
      Long integer encoded as a JSON string to preserve precision (e.g. account
      IDs).
servers:
  - description: app.bron.org
    url: https://api.bron.org
security: []
tags:
  - name: stake
  - name: balances
  - name: addresses
  - name: intents
  - name: assets
  - name: transaction-limits
  - name: canton
  - name: address-book
  - name: workspaces
  - name: accounts
  - name: transactions
paths:
  /workspaces/{workspaceId}/canton/ledger-query:
    post:
      tags:
        - canton
      summary: Canton Ledger API passthrough
      description: >-
        Forwards a whitelisted Canton JSON Ledger API request on behalf of a
        wallet connected via WalletConnect. This route only proxies a read-only
        set of requests after validating ownership of the calling parties.


        <sup>API Key permissions: Transaction Operator, Full Access</sup>
      parameters:
        - in: path
          name: workspaceId
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CantonLedgerQuery'
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CantonLedgerQueryResult'
          description: OK
        '400':
          content:
            application/json:
              schema:
                properties:
                  error:
                    description: The machine-readable error code
                    examples:
                      - bad-request
                    type: string
                  message:
                    description: >-
                      A human-readable message providing more details about the
                      error
                    type: string
                type: object
          description: Bad Request
        '403':
          content:
            application/json:
              schema:
                properties:
                  error:
                    description: The machine-readable error code
                    examples:
                      - forbidden
                    type: string
                  message:
                    description: >-
                      A human-readable message providing more details about the
                      error
                    type: string
                type: object
          description: Forbidden
        '409':
          content:
            application/json:
              schema:
                properties:
                  error:
                    description: The machine-readable error code
                    examples:
                      - conflict
                    type: string
                  message:
                    description: >-
                      A human-readable message providing more details about the
                      error
                    type: string
                type: object
          description: Conflict
components:
  schemas:
    CantonLedgerQuery:
      properties:
        accountId:
          description: >-
            Account whose Canton party identifiers are used as the calling
            parties for the forwarded request.
          type: string
        params:
          description: >-
            Canton Ledger JSON API request envelope; mirrors the
            @canton-network/dapp-sdk LedgerApiParams shape ({ requestMethod,
            resource, body?, query?, path? }). This route forwards a whitelisted
            set of read-only requests on behalf of a wallet connected via
            WalletConnect.
          type: com.fasterxml.jackson.databind.JsonNode
        sessionTopic:
          description: WalletConnect session topic for audit correlation.
          type: string
      required:
        - accountId
        - sessionTopic
        - params
      type: object
    CantonLedgerQueryResult:
      properties:
        result:
          description: >-
            Raw response body returned by the Canton Ledger JSON API; forwarded
            unchanged.
          type: com.fasterxml.jackson.databind.JsonNode
        status:
          description: HTTP status returned by the Canton Ledger JSON API.
          format: int32
          type: string
      type: object

````