List transactions from a ledger

List transactions from a ledger, sorted by id in descending order.

GET /api/ledger/v2/{ledger}/transactions

Try it

List transactions from a ledger

cURL

curl --request GET \
  --url http://localhost/api/ledger/v2/{ledger}/transactions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{}'

200

{
  "cursor": {
    "pageSize": 15,
    "hasMore": false,
    "data": [
      {
        "timestamp": "2023-11-07T05:31:56Z",
        "postings": [
          {
            "amount": 100,
            "asset": "COIN",
            "destination": "users:002",
            "source": "users:001"
          }
        ],
        "metadata": {
          "admin": "true"
        },
        "id": 1,
        "reverted": true,
        "insertedAt": "2023-11-07T05:31:56Z",
        "updatedAt": "2023-11-07T05:31:56Z",
        "reference": "ref:001",
        "revertedAt": "2023-11-07T05:31:56Z",
        "preCommitVolumes": {
          "orders:1": {
            "USD": {
              "input": 100,
              "output": 10,
              "balance": 90
            }
          },
          "orders:2": {
            "USD": {
              "input": 100,
              "output": 10,
              "balance": 90
            }
          }
        },
        "postCommitVolumes": {
          "orders:1": {
            "USD": {
              "input": 100,
              "output": 10,
              "balance": 90
            }
          },
          "orders:2": {
            "USD": {
              "input": 100,
              "output": 10,
              "balance": 90
            }
          }
        },
        "preCommitEffectiveVolumes": {
          "orders:1": {
            "USD": {
              "input": 100,
              "output": 10,
              "balance": 90
            }
          },
          "orders:2": {
            "USD": {
              "input": 100,
              "output": 10,
              "balance": 90
            }
          }
        },
        "postCommitEffectiveVolumes": {
          "orders:1": {
            "USD": {
              "input": 100,
              "output": 10,
              "balance": 90
            }
          },
          "orders:2": {
            "USD": {
              "input": 100,
              "output": 10,
              "balance": 90
            }
          }
        }
      }
    ],
    "previous": "YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol=",
    "next": ""
  }
}

Authorizations

Authorization · string · header · required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

ledger · string · required

Name of the ledger.

Example:

"ledger001"

Query Parameters

pageSize · integer<int64>

The maximum number of results to return per page.

Required range: 1 <= x <= 1000

cursor · string

Parameter used in pagination requests. Maximum page size is set to 15. Set to the value of next for the next page of results. Set to the value of previous for the previous page of results. No other parameters can be set when this parameter is set.

Example:

"aHR0cHM6Ly9nLnBhZ2UvTmVrby1SYW1lbj9zaGFyZQ=="

expand · string

pit · string<date-time>

order · enum<string>

Deprecated: Use sort param

Available options: effective

reverse · boolean

sort · string

Sort results using a field name and order (ascending or descending). Format: <field>:<order>, where <field> is the field name and <order> is either asc or desc.

Example:

"id:desc"

Body

application/json

The body is of type object.

Response

200

application/json

OK

cursor · object · required

Show child attributes

cursor. pageSize · integer<int64> · required

Required range: 1 <= x <= 1000

Example:

15

cursor. hasMore · boolean · required

Example:

false

cursor. data · object[] · required

Show child attributes

cursor.data. timestamp · string<date-time> · required

cursor.data. postings · object[] · required

Show child attributes

cursor.data.postings. amount · integer<bigint> · required

Required range: x >= 0

Example:

100

cursor.data.postings. asset · string · required

Example:

"COIN"

cursor.data.postings. destination · string · required

Example:

"users:002"

cursor.data.postings. source · string · required

Example:

"users:001"

cursor.data. metadata · object · required

Show child attributes

cursor.data.metadata. {key} · string

Example:

{ "admin": "true" }

cursor.data. id · integer<bigint> · required

Required range: x >= 0

cursor.data. reverted · boolean · required

cursor.data. insertedAt · string<date-time>

cursor.data. updatedAt · string<date-time>

cursor.data. reference · string

Example:

"ref:001"

cursor.data. revertedAt · string<date-time>

cursor.data. preCommitVolumes · object

Show child attributes

cursor.data.preCommitVolumes. {key} · object

Show child attributes

cursor.data.preCommitVolumes.{key}. {key} · object

Show child attributes

cursor.data.preCommitVolumes.{key}.{key}. input · integer<bigint> · required

cursor.data.preCommitVolumes.{key}.{key}. output · integer<bigint> · required

cursor.data.preCommitVolumes.{key}.{key}. balance · integer<bigint>

Example:

{ "input": 100, "output": 20, "balance": 80 }

Example:

{
  "USD": { "input": 100, "output": 10, "balance": 90 },
  "EUR": { "input": 100, "output": 10, "balance": 90 }
}

Example:

{
  "orders:1": {
    "USD": { "input": 100, "output": 10, "balance": 90 }
  },
  "orders:2": {
    "USD": { "input": 100, "output": 10, "balance": 90 }
  }
}

cursor.data. postCommitVolumes · object

Show child attributes

cursor.data.postCommitVolumes. {key} · object

Show child attributes

cursor.data.postCommitVolumes.{key}. {key} · object

Show child attributes

cursor.data.postCommitVolumes.{key}.{key}. input · integer<bigint> · required

cursor.data.postCommitVolumes.{key}.{key}. output · integer<bigint> · required

cursor.data.postCommitVolumes.{key}.{key}. balance · integer<bigint>

Example:

{ "input": 100, "output": 20, "balance": 80 }

Example:

{
  "USD": { "input": 100, "output": 10, "balance": 90 },
  "EUR": { "input": 100, "output": 10, "balance": 90 }
}

Example:

{
  "orders:1": {
    "USD": { "input": 100, "output": 10, "balance": 90 }
  },
  "orders:2": {
    "USD": { "input": 100, "output": 10, "balance": 90 }
  }
}

cursor.data. preCommitEffectiveVolumes · object

Show child attributes

cursor.data.preCommitEffectiveVolumes. {key} · object

Show child attributes

cursor.data.preCommitEffectiveVolumes.{key}. {key} · object

Show child attributes

cursor.data.preCommitEffectiveVolumes.{key}.{key}. input · integer<bigint> · required

cursor.data.preCommitEffectiveVolumes.{key}.{key}. output · integer<bigint> · required

cursor.data.preCommitEffectiveVolumes.{key}.{key}. balance · integer<bigint>

Example:

{ "input": 100, "output": 20, "balance": 80 }

Example:

{
  "USD": { "input": 100, "output": 10, "balance": 90 },
  "EUR": { "input": 100, "output": 10, "balance": 90 }
}

Example:

{
  "orders:1": {
    "USD": { "input": 100, "output": 10, "balance": 90 }
  },
  "orders:2": {
    "USD": { "input": 100, "output": 10, "balance": 90 }
  }
}

cursor.data. postCommitEffectiveVolumes · object

Show child attributes

cursor.data.postCommitEffectiveVolumes. {key} · object

Show child attributes

cursor.data.postCommitEffectiveVolumes.{key}. {key} · object

Show child attributes

cursor.data.postCommitEffectiveVolumes.{key}.{key}. input · integer<bigint> · required

cursor.data.postCommitEffectiveVolumes.{key}.{key}. output · integer<bigint> · required

cursor.data.postCommitEffectiveVolumes.{key}.{key}. balance · integer<bigint>

Example:

{ "input": 100, "output": 20, "balance": 80 }

Example:

{
  "USD": { "input": 100, "output": 10, "balance": 90 },
  "EUR": { "input": 100, "output": 10, "balance": 90 }
}

Example:

{
  "orders:1": {
    "USD": { "input": 100, "output": 10, "balance": 90 }
  },
  "orders:2": {
    "USD": { "input": 100, "output": 10, "balance": 90 }
  }
}

cursor. previous · string

Example:

"YXVsdCBhbmQgYSBtYXhpbXVtIG1heF9yZXN1bHRzLol="

cursor. next · string

Example:

""