List Transactions Made
Track and review your transaction history.
This article guides you through the process of listing all transactions associated with your account. Whether you're auditing your records, reconciling balances, or simply keeping track of your actions, this feature allows you to easily access a detailed overview of your past transactions and understand your activity within the system.
The GET /mint_platform/v1/transactions method returns a paginated list of transactions that match the given query parameters. The method can also retrieve the details of a specific transaction by giving the transaction ID as a path parameter.
To list the transactions made in your account, send the following HTTP request. This endpoint requires the "View account information" permission enabled in your API key.
GET https://stage.buildwithjuno.com/mint_platform/v1/transactions
Path Parameter
| Parameter Name | Description |
|---|---|
transactionID | The Juno-provided unique identifier of the transaction. The service returns this ID in the response object of successful redemptions and crypto withdrawals. In the case of issuances, an asynchronous operation, search for its ID by calling the GET /mint_platform/v1/transactions endpoint using the query parameter type=ISSUANCE. |
Query Parameters
| Parameter Name | Description | Required |
|---|---|---|
amountFrom | Filters transactions with an amount greater than or equal to the specified value. | No |
amountTo | Filters transactions with an amount less than or equal to the specified value. | No |
isoDateFrom | Returns the transactions whose creation date lies on or after the defined date. If used together, ensure the value of this parameter comes before the value of isoDateTo. Specify it in ISO 8601 date format, YYYY-MM-DDTHH:MM:SSZ. | No |
isoDateTo | Returns the transactions whose creation date lies on or before the defined date. If used together, ensure the value of this parameter comes after the value of isoDateTo. Specify it in ISO 8601 date format, YYYY-MM-DDTHH:MM:SSZ. | No |
page | The page number to retrieve, default value = 0. | No |
size | The number of items per page, default value = 10, maximum value = 100. | No |
sort | The sorting criteria, default value = createdAt,DESC. DESC means descending sort, from highest to lowest. ASC is the opposite operation. Other values you can use: transactionType,DESC, transactionType,ASC, summaryStatus,DESC, summaryStatus,ASC, amount,ASC, createdAt,ASC. In the case of transactionType and summaryStatus, the sort is by alphabetical order; for the amount, it is numerical, and createdAt is by creation date and time. Sorting is performed at a single level. For instance, when sorting by transactionType, the types are arranged alphabetically. However, transactions within the same type are not further sorted based on any additional criteria. | No |
status | Filters the transactions that meet the specified state. Valid values: PROCESSING, SUCCEEDED, FAILED. | No |
type | Filters the transactions of the given type. Valid values: ISSUANCE, REDEMPTION, CRYPTO_DEPOSIT, CRYPTO_WITHDRAWAL. | No |
Examples
The search shown on the left tab sorts the retrieved transactions by their state, displaying only a subset of the returned results, and the query on the right tab sorts the retrieved transactions by their type, again, displaying only a subset.
curl https://stage.buildwithjuno.com/mint_platform/v1/transactions?sort=summaryStatus,ASC&size=20
{
"success": true,
"payload": {
"content": [
{
"id": "81fc0725-849f-4af5-a5f5-e24e0f04a58b",
"amount": 100.33,
"currency": "mxn",
"transaction_type": "REDEMPTION",
"summary_status": "PROCESSING",
"created_at": "2025-01-28T19:10:39.265166Z",
"updated_at": "2025-01-28T19:12:00.362952Z"
},
{
"id": "72f2c54c-37e7-41c9-867b-50e401ddea2f",
"amount": 100,
"currency": "mxn",
"transaction_type": "REDEMPTION",
"summary_status": "PROCESSING",
"created_at": "2025-01-28T14:56:30.769325Z",
"updated_at": "2025-01-28T14:56:30.769325Z"
},
{
"id": "74f51312-98f4-4ff5-8a7d-6b4fac40cb62",
"amount": 500.33,
"currency": "mxn",
"transaction_type": "REDEMPTION",
"summary_status": "SUCCEEDED",
"created_at": "2025-01-28T19:10:52.549308Z",
"updated_at": "2025-01-28T20:16:05.203697Z"
},
{
"id": "0ff2bfd0-78aa-4e95-940b-d7832fa46edd",
"amount": 2000,
"currency": "mxn",
"transaction_type": "ISSUANCE",
"summary_status": "SUCCEEDED",
"created_at": "2025-01-27T15:49:52.056318Z",
"updated_at": "2025-01-27T15:51:05.050127Z"
}
],
"pageable": {
"page_number": 0,
"page_size": 20,
"sort": {
"empty": false,
"sorted": true,
"unsorted": false
},
"offset": 0,
"paged": true,
"unpaged": false
},
"last": true,
"total_pages": 1,
"total_elements": 13,
"size": 20,
"number": 0,
"sort": {
"empty": false,
"sorted": true,
"unsorted": false
},
"first": true,
"number_of_elements": 13,
"empty": false
}
}
curl https://stage.buildwithjuno.com/mint_platform/v1/transactions?sort=transactionType,ASC&size=20
{
"success": true,
"payload": {
"content": [
{
"id": "0ff2bfd0-78aa-4e95-940b-d7832fa46edd",
"amount": 2000,
"currency": "mxn",
"transaction_type": "ISSUANCE",
"summary_status": "SUCCEEDED",
"created_at": "2025-01-27T15:49:52.056318Z",
"updated_at": "2025-01-27T15:51:05.050127Z"
},
{
"id": "fc0c3c8e-8ce4-422e-b1a0-dec6997d4689",
"amount": 54.33,
"currency": "mxn",
"transaction_type": "REDEMPTION",
"summary_status": "PROCESSING",
"created_at": "2025-01-28T19:10:25.776687Z",
"updated_at": "2025-01-28T19:11:55.064829Z"
},
{
"id": "739d4d27-13e2-422c-acf2-5db9594a8d10",
"amount": 100,
"currency": "mxn",
"transaction_type": "REDEMPTION",
"summary_status": "PROCESSING",
"created_at": "2025-01-27T23:09:24.561805Z",
"updated_at": "2025-01-27T23:09:24.561805Z"
}
],
"pageable": {
"page_number": 0,
"page_size": 20,
"sort": {
"empty": false,
"sorted": true,
"unsorted": false
},
"offset": 0,
"paged": true,
"unpaged": false
},
"last": true,
"total_pages": 1,
"total_elements": 13,
"size": 20,
"number": 0,
"sort": {
"empty": false,
"sorted": true,
"unsorted": false
},
"first": true,
"number_of_elements": 13,
"empty": false
}
}
Updated 9 days ago