---
updatedAt: 2026-06-30T22:48:59.000Z
agentTools:
  projectIndex: https://docs.datanomik.com/llms.txt
---

# List Investment Movements

Flat list of investment movements from automatic applications. Role: ROLE_INVESTMENTS_READ.

Paginated response (page, size, sort).

# 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/investments/movements": {
      "get": {
        "responses": {
          "200": {
            "description": "",
            "content": {
              "application/json": {
                "examples": {
                  "OK": {
                    "summary": "OK",
                    "value": {
                      "content": [
                        {
                          "id": "11111111-1111-1111-1111-111111111111",
                          "application_id": "22222222-2222-2222-2222-222222222222",
                          "instrument_type": "DEPOSIT",
                          "direction": "REDEEM",
                          "date": "2026-06-30",
                          "account_type": "Conta Corrente",
                          "account_number": "0000 | 00000-0",
                          "owner_document": "12.345.678/0001-99",
                          "institution_name": "Itau",
                          "institution_logo": "https://resources.datanomik.com/institutions/br/Itau.svg",
                          "owner_id": "33333333-3333-3333-3333-333333333333",
                          "owner_name": "000 | EXAMPLE OWNER NAME",
                          "institution_id": "44444444-4444-4444-4444-444444444444",
                          "type": "Renda Fixa",
                          "asset": "CDB-DI",
                          "value": -5074.26,
                          "gross_value": -5074.26,
                          "net_value": 5059.58,
                          "income_tax_value": 14.68,
                          "note_available": false
                        }
                      ],
                      "first": true,
                      "last": false,
                      "page_number": 0,
                      "page_size": 1,
                      "total_elements": 11345,
                      "total_pages": 11345
                    }
                  }
                }
              }
            }
          },
          "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": "Unauthorized. Missing or invalid Basic Auth credentials.",
            "content": {
              "application/json": {
                "examples": {
                  "UNAUTHORIZED": {
                    "value": "{\n    \"code\": 401,\n    \"type\": \"UNAUTHORIZED\",\n    \"message\": \"Invalid credentials.\",\n    \"traceId\": \"0af7651916cd43dd8448eb211c80319c\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "code": {
                      "type": "integer",
                      "example": 401
                    },
                    "type": {
                      "type": "string",
                      "example": "UNAUTHORIZED"
                    },
                    "message": {
                      "type": "string",
                      "example": "Invalid credentials."
                    },
                    "traceId": {
                      "type": "string",
                      "example": "0af7651916cd43dd8448eb211c80319c"
                    }
                  }
                }
              }
            }
          },
          "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"
                    }
                  }
                }
              }
            }
          }
        },
        "parameters": [
          {
            "in": "query",
            "name": "instrumentType",
            "schema": {
              "type": "string"
            },
            "description": "Instrument type: COE, BOND, FUND, STOCKS, DEPOSIT, COMMITTED or DERIVATIVE"
          },
          {
            "in": "query",
            "name": "direction",
            "schema": {
              "type": "string"
            },
            "description": "Movement type: APPLY or REDEEM"
          },
          {
            "in": "query",
            "name": "investmentId",
            "schema": {
              "type": "string"
            },
            "description": "Investment identifier"
          },
          {
            "in": "query",
            "name": "accountId",
            "schema": {
              "type": "string"
            },
            "description": "Account identifier"
          },
          {
            "in": "query",
            "name": "applicationId",
            "schema": {
              "type": "string"
            },
            "description": "Application identifier"
          },
          {
            "in": "query",
            "name": "ownerId",
            "schema": {
              "type": "string"
            },
            "description": "Owner identifier"
          },
          {
            "in": "query",
            "name": "generalOwnerId",
            "schema": {
              "type": "string"
            },
            "description": "General owner identifier"
          },
          {
            "in": "query",
            "name": "institutionId",
            "schema": {
              "type": "string"
            },
            "description": "Institution identifier"
          },
          {
            "in": "query",
            "name": "linkId",
            "schema": {
              "type": "string"
            },
            "description": "Link identifier"
          },
          {
            "in": "query",
            "name": "dateFrom",
            "schema": {
              "type": "string"
            },
            "description": "Start date (YYYY-MM-DD)"
          },
          {
            "in": "query",
            "name": "dateTo",
            "schema": {
              "type": "string"
            },
            "description": "End date (YYYY-MM-DD)"
          },
          {
            "in": "query",
            "name": "noteAvailableOnly",
            "schema": {
              "type": "boolean"
            },
            "description": "Only movements with an available receipt"
          }
        ],
        "summary": "List Investment Movements",
        "operationId": "get_v1-investments-movements",
        "description": "Flat list of investment movements from automatic applications. Role: ROLE_INVESTMENTS_READ."
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```