---
updatedAt: 2026-09-16T12:23:30.000Z
agentTools:
  projectIndex: https://docs.datanomik.com/llms.txt
---

# List Transactions

List all transactions of yours links

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "openbanking-api",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.datanomik.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "http",
        "scheme": "basic"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/v1/transactions": {
      "get": {
        "summary": "List Transactions",
        "description": "List all transactions of yours links",
        "operationId": "list-transactions",
        "parameters": [
          {
            "name": "linkId",
            "in": "query",
            "description": "Identifier of the link from which you want to get detailed information about.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "accountId",
            "in": "query",
            "description": "Identifier of the account from which you want to get detailed information about.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "dateFrom",
            "in": "query",
            "description": "Date format: YYYY-MM-dd",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "dateTo",
            "in": "query",
            "description": "Date format: YYYY-MM-dd",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "currency",
            "in": "query",
            "description": "Currency code in ISO 4217 format",
            "schema": {
              "type": "string",
              "enum": [
                "ARS",
                "BRL",
                "USD",
                "PEN",
                "CLP",
                "EUR",
                "PYG",
                "COP",
                "HNL",
                "UYU"
              ]
            }
          },
          {
            "name": "institutionId",
            "in": "query",
            "description": "Institution Id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "country",
            "in": "query",
            "description": "Country Enum",
            "schema": {
              "type": "string",
              "enum": [
                "AR",
                "BR",
                "BO",
                "CO",
                "CH",
                "PY",
                "PE",
                "UY",
                "HN"
              ]
            }
          },
          {
            "name": "trxType",
            "in": "query",
            "description": "Trx Type Enum",
            "schema": {
              "type": "string",
              "enum": [
                "INFLOW",
                "OUTFLOW"
              ]
            }
          },
          {
            "name": "ownerId",
            "in": "query",
            "description": "Owner Id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "amountFrom",
            "in": "query",
            "description": "Greater or Equals Than",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "amountTo",
            "in": "query",
            "description": "Less or Equals Than",
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "institution",
            "in": "query",
            "description": "Institution Name",
            "schema": {
              "type": "string",
              "enum": [
                ""
              ]
            }
          },
          {
            "name": "status",
            "in": "query",
            "description": "Transaction Status",
            "schema": {
              "type": "string",
              "enum": [
                "APPROVED",
                "EXPIRED",
                "CREATED",
                "BLOCKED",
                "REFUSED",
                "PENDING",
                "REFUND",
                "CHARGEBACK",
                "TAX_FEE",
                "CASHOUT"
              ]
            }
          },
          {
            "name": "description",
            "in": "query",
            "description": "Transaction Description",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "transactionId",
            "in": "query",
            "description": "Transaction Id",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "senderName",
            "in": "query",
            "description": "Sender Name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "beneficiaryName",
            "in": "query",
            "description": "Beneficiary Name",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "reference",
            "in": "query",
            "description": "Transaction Reference",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "categoryId",
            "in": "query",
            "description": "Category Identifier",
            "schema": {
              "type": "string"
            }
          },
          {
            "in": "query",
            "name": "descriptionNot",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            },
            "description": "Excluded descriptions"
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"content\": [\n        {\n            \"id\": \"21106d42-0276-4009-9602-603f28e0be83\",\n            \"date\": \"2022-05-17\",\n            \"description\": \"TARIFA POR SERVICOS\",\n            \"reference\": \"657474\",\n            \"type\": \"OUTFLOW\",\n            \"currency\": \"UYU\",\n            \"amount\": -8106.0,\n            \"balance\": 30975.0,\n            \"created_at\": \"2022-05-17T19:20:06.810658Z\",\n            \"updated_at\": \"2022-05-17T19:20:06.810674Z\",\n            \"beneficiary\": {\n                \"document\": \"1234567\",\n                \"document_type\": \"CPF\"\n            },\n            \"link\": {\n                \"id\": \"968582ab-33c7-4234-a53f-f123c28f8b76\",\n                \"country\": \"BR\",\n                \"institution\": \"BRADESCO\",\n                \"institution_logo\": \"https://resources.datanomik.com/institutions/uy/Bradesco.svg\"\n            },\n            \"account\": {\n                \"id\": \"5fffe133-7707-41b6-86c9-3c260662a25d\",\n                \"account_number\": \"45555223\",\n                \"type\": \"CA\"\n            }\n        },\n        {\n            \"id\": \"1c222ffe-8f03-4229-8c04-72e85de6dcf9\",\n            \"date\": \"2022-05-17\",\n            \"description\": \"TRANSFERENCIA ENTRE CUENTAS\",\n            \"reference\": \"241951\",\n            \"type\": \"INFLOW\",\n            \"currency\": \"EUR\",\n            \"amount\": 8418.0,\n            \"balance\": 93907.0,\n            \"created_at\": \"2022-05-17T14:15:19.256252Z\",\n            \"updated_at\": \"2022-05-17T14:15:19.256253Z\",\n            \"sender\": {\n                \"document\": \"1234567\",\n                \"document_type\": \"CPF\"\n            },\n            \"link\": {\n                \"id\": \"16d6f3d4-1a07-45ca-b7db-44e27b4ff4d6\",\n                \"country\": \"BR\",\n                \"institution\": \"BRADESCO\",\n                \"institution_logo\": \"https://resources.datanomik.com/institutions/uy/Bradesco.svg\"\n            },\n            \"account\": {\n                \"id\": \"0f7f6012-880a-4356-92b8-6e8818599bd8\",\n                \"account_number\": \"45555223\",\n                \"type\": \"CC\"\n            }\n        }\n    ],\n    \"first\": true,\n    \"last\": true,\n    \"page_number\": 0,\n    \"page_size\": 100,\n    \"total_elements\": 2,\n    \"total_pages\": 1\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "content": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": {
                            "type": "string",
                            "example": "21106d42-0276-4009-9602-603f28e0be83"
                          },
                          "date": {
                            "type": "string",
                            "example": "2022-05-17"
                          },
                          "description": {
                            "type": "string",
                            "example": "TARIFA POR SERVICOS"
                          },
                          "reference": {
                            "type": "string",
                            "example": "657474"
                          },
                          "type": {
                            "type": "string",
                            "example": "OUTFLOW"
                          },
                          "currency": {
                            "type": "string",
                            "example": "UYU"
                          },
                          "amount": {
                            "type": "integer",
                            "example": -8106,
                            "default": 0
                          },
                          "balance": {
                            "type": "integer",
                            "example": 30975,
                            "default": 0
                          },
                          "created_at": {
                            "type": "string",
                            "example": "2022-05-17T19:20:06.810658Z"
                          },
                          "updated_at": {
                            "type": "string",
                            "example": "2022-05-17T19:20:06.810674Z"
                          },
                          "beneficiary": {
                            "type": "object",
                            "properties": {
                              "document": {
                                "type": "string",
                                "example": "1234567"
                              },
                              "document_type": {
                                "type": "string",
                                "example": "CPF"
                              }
                            }
                          },
                          "link": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "example": "968582ab-33c7-4234-a53f-f123c28f8b76"
                              },
                              "country": {
                                "type": "string",
                                "example": "BR"
                              },
                              "institution": {
                                "type": "string",
                                "example": "BRADESCO"
                              },
                              "institution_logo": {
                                "type": "string",
                                "example": "https://resources.datanomik.com/institutions/uy/Bradesco.svg"
                              }
                            }
                          },
                          "account": {
                            "type": "object",
                            "properties": {
                              "id": {
                                "type": "string",
                                "example": "5fffe133-7707-41b6-86c9-3c260662a25d"
                              },
                              "account_number": {
                                "type": "string",
                                "example": "45555223"
                              },
                              "type": {
                                "type": "string",
                                "example": "CA"
                              }
                            }
                          }
                        }
                      }
                    },
                    "first": {
                      "type": "boolean",
                      "example": true,
                      "default": true
                    },
                    "last": {
                      "type": "boolean",
                      "example": true,
                      "default": true
                    },
                    "page_number": {
                      "type": "integer",
                      "example": 0,
                      "default": 0
                    },
                    "page_size": {
                      "type": "integer",
                      "example": 100,
                      "default": 0
                    },
                    "total_elements": {
                      "type": "integer",
                      "example": 2,
                      "default": 0
                    },
                    "total_pages": {
                      "type": "integer",
                      "example": 1,
                      "default": 0
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request. Invalid or missing parameters/body, or a business rule that rejects the request.",
            "content": {
              "application/json": {
                "examples": {
                  "BEAN_VALIDATION_ERROR": {
                    "value": "{\n    \"code\": 402,\n    \"type\": \"BEAN_VALIDATION_ERROR\",\n    \"message\": \"Invalid arguments for specific request. Please check details to satisfy validations\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\",\n    \"details\": [\n        \"linkId: must not be blank\"\n    ]\n}"
                  },
                  "TYPE_MISMATCH": {
                    "value": "{\n    \"code\": 454,\n    \"type\": \"TYPE_MISMATCH\",\n    \"message\": \"Type mismatch for parameter\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 402
                    },
                    "type": {
                      "type": "string",
                      "example": "BEAN_VALIDATION_ERROR"
                    },
                    "message": {
                      "type": "string",
                      "example": "Invalid arguments for specific request. Please check details to satisfy validations"
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    },
                    "details": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      },
                      "example": [
                        "linkId: must not be blank"
                      ]
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n  \"code\": 401,\n  \"type\": \"UNAUTHORIZED\",\n  \"message\": \"Invalid credentials\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 401,
                      "default": 0
                    },
                    "type": {
                      "type": "string",
                      "example": "UNAUTHORIZED"
                    },
                    "message": {
                      "type": "string",
                      "example": "Invalid credentials"
                    }
                  }
                }
              }
            }
          },
          "403": {
            "description": "Forbidden. Source IP not whitelisted, credentials without the required scope, or trial period expired.",
            "content": {
              "application/json": {
                "examples": {
                  "IP_NOT_ALLOWED": {
                    "value": "{\n    \"code\": 632,\n    \"type\": \"IP_NOT_ALLOWED\",\n    \"message\": \"Source ip address not allowed.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  },
                  "FORBIDDEN": {
                    "value": "{\n    \"code\": 403,\n    \"type\": \"FORBIDDEN\",\n    \"message\": \"Forbidden\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 632
                    },
                    "type": {
                      "type": "string",
                      "example": "IP_NOT_ALLOWED"
                    },
                    "message": {
                      "type": "string",
                      "example": "Source ip address not allowed."
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    }
                  }
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error. Unexpected error; report the `traceId` to support.",
            "content": {
              "application/json": {
                "examples": {
                  "INTERNAL_ERROR": {
                    "value": "{\n    \"code\": 500,\n    \"type\": \"INTERNAL_ERROR\",\n    \"message\": \"Unexpected error. Please contact support with the traceId.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 500
                    },
                    "type": {
                      "type": "string",
                      "example": "INTERNAL_ERROR"
                    },
                    "message": {
                      "type": "string",
                      "example": "Unexpected error. Please contact support with the traceId."
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```