# Listar transacciones de inversión ## ▶️ Uso Con el método List Investment Transactions, puedes: 1. Listar transacciones de inversión relacionadas con un específico (usando el parámetro de consulta ). 2. Obtener los detalles de un específico (usando el parámetro de consulta ). ## 📖 Paginación Este método devuelve una respuesta paginada (por defecto: 100 elementos por página). Puedes usar el parámetro de consulta para aumentar el número de elementos devueltos hasta un máximo de 1000 elementos. Puedes usar el parámetro de consulta para navegar a través de los resultados. Para más detalles sobre cómo navegar por las respuestas paginadas de Belvo, consulta nuestro artículo Consejos de Paginación. ## 🔦 Filtrado de Respuestas Consulta la lista de campos a continuación para ver los campos por los que puedes filtrar tus respuestas. Para más información sobre cómo usar filtros, consulta nuestro artículo Filtrado de respuestas. Endpoint: GET /api/br/investment-transactions/ Version: 1.223.0 Security: basicAuth ## Query parameters: - `link` (string, required) El por el que deseas filtrar. Example: "8848bd0c-9c7e-4f53-a732-ec896b11d4c4" - `page_size` (integer) Indica cuántos resultados devolver por página. Por defecto, devolvemos 100 resultados por página. ℹ️ El número mínimo de resultados devueltos por página es 1 y el máximo es 1000. Si introduces un valor mayor que 1000, nuestra API usará por defecto el valor máximo (1000). Example: 100 - `page` (integer) Un número de página dentro del conjunto de resultados paginados. Example: 1 - `id` (string) Devuelve información solo para este recurso . Example: "24ccab1d-3a86-4136-a6eb-e04bf52b356f" - `id__in` (array) Devuelve información para estos s de recursos. Example: ["6b3dea0f-be29-49d1-aabe-1a6d588642e6"] - `link__in` (array) Devuelve resultados solo para estos s. Example: ["5722d0ba-69d7-42dc-8ff5-33767b83c5d6"] - `omit` (string) Omite ciertos campos para que no se devuelvan en la respuesta. Para más información, consulta nuestro artículo del DevPortal Filtrando respuestas. - `fields` (string) Devuelve solo los campos especificados en la respuesta. Para obtener más información, consulta nuestro artículo del DevPortal Filtrando respuestas. - `type` (string) Devuelve inversiones con este tipo. Puede ser , , , o . Example: "VARIABLE" - `type__in` (array) Devolución de inversiones de este tipo. Puede ser , , , o . Example: ["VARIABLE"] - `created_at` (string) Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo en esta fecha (en formato ). Example: "2022-05-05" - `created_at__gt` (string) Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después de esta fecha (en formato ). Example: "2022-05-05" - `created_at__gte` (string) Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo después o en esta fecha (en formato ). Example: "2022-05-04" - `created_at__lt` (string) Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes de esta fecha (en formato ). Example: "2022-04-01" - `created_at__lte` (string) Devuelve los elementos que se actualizaron por última vez en la base de datos de Belvo antes o en esta fecha (en formato ). Example: "2022-03-30" - `created_at__range` (array) Devolver cuentas que fueron actualizadas por última vez en la base de datos de Belvo entre dos fechas (en formato ). Example: ["2022-03-03"] ## Response 200 fields (application/json): - `count` (integer) El número total de resultados en tu cuenta de Belvo. Example: 130 - `next` (string,null) La URL a la siguiente página de resultados. Cada página consta de hasta 100 elementos. Si no hay suficientes resultados para una página adicional, el valor es . En nuestro ejemplo de documentación, usamos como un valor de marcador de posición. En producción, este valor será reemplazado por el endpoint real que estás utilizando actualmente (por ejemplo, o ). Example: "https://sandbox.belvo.com/api/{endpoint}/?link=1bd948f7-245d-4313-b604-34d1044cb908page=2" - `previous` (string,null) La URL a la página anterior de resultados. Si no hay una página anterior, el valor es . - `results` (array) Matriz de objetos de transacciones de inversión. - `results.id` (string) Identificador único de Belvo para el elemento actual. Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d" - `results.link` (string,null) El al que pertenecen los datos. Example: "30cb4806-6e00-48a4-91c9-ca55968576c8" - `results.collected_at` (string) La marca de tiempo ISO-8601 cuando se recopiló el punto de datos. Example: "2022-02-09T08:45:50.406032Z" - `results.created_at` (string) La marca de tiempo ISO-8601 de cuando se creó el punto de datos en la base de datos de Belvo. Example: "2022-02-09T08:45:50.406032Z" - `results.investment` (object) - `results.investment.id` (string) El identificador único creado por Belvo utilizado para referenciar la inversión actual. Example: "5359ddc5-31fc-4346-934b-cc24630a8d06" - `results.investment.type` (string) El tipo de inversión: Puede ser - () - () - () - () - () Example: "FIXED_INCOME_BANKING" - `results.investment.issuer_id_number` (string,null) El número de CNPJ de la institución emisora. Para los Fondos de Inversión, este es el CNPJ del fondo. > 🚧 No aplicable para inversiones en . Example: "10187609364567" - `results.investment.isin_number` (string,null) El Número de Identificación de Valores Internacionales ISO-6166 (ISIN) para el instrumento financiero. Example: "BRCST4CTF001" - `results.investment.currency` (string) El código de moneda de tres letras (ISO-4217) de la inversión. Por ejemplo, para el Real Brasileño. Example: "BRL" - `results.investment.product_name` (string) El nombre del producto de inversión. - Para , puede ser: CDB, RDB, LCI o LCA. - Para , puede ser: DEBENTURES, CRI o CRA. - Para , será el nombre del fondo. Por ejemplo: CONSTELLATION MASTER FIA - Para , será el nombre del bono. Por ejemplo: Tesouro Selic 2025. - Para , será el nombre de la acción. Por ejemplo AAPL. Example: "CONSTELLATION MASTER FIA" - `results.investment.is_tax_exempt` (boolean) Indica si la inversión está exenta de impuestos. > 🚧 Solo aplicable para inversiones de tipo . - `results.investment.clearing_code` (string,null) El código de compensación de la inversión. > 🚧 Solo aplicable para y . Example: "CDB421GPXXX" - `results.investment.due_date` (string,null) La fecha de vencimiento del instrumento financiero. > 🚧 Solo aplicable para inversiones en , y . Example: "2022-01-01" - `results.investment.issue_date` (string,null) La fecha en que se emitió el instrumento financiero. > 🚧 Solo aplicable para y . Example: "2021-01-01" - `results.investment.purchase_date` (string,null) La fecha en que se adquirió el instrumento financiero. > 🚧 Solo aplicable para inversiones en , y . Example: "2021-01-01" - `results.investment.grace_period_date` (string,null) La fecha del período de gracia del instrumento financiero. > 🚧 Solo aplicable para y . Example: "2021-01-01" - `results.investment.issue_unit_price` (number,null) El precio unitario del instrumento financiero en el momento de la emisión. > 🚧 Solo aplicable para y . Example: 1000 - `results.investment.balance` (object) El saldo del instrumento de inversión, a partir de la . - `results.investment.balance.reference_date` (string) La fecha y hora en que se calculó el saldo para el instrumento de inversión, en formato . Example: "2022-07-21T17:32:00Z" - `results.investment.balance.gross_value` (number) El valor bruto del instrumento de inversión. Example: 1000 - `results.investment.balance.blocked_amount` (number) La cantidad del instrumento de inversión que está bloqueada o no disponible para transacciones. Example: 100 - `results.investment.balance.quantity` (number) El número de unidades, cuotas o activos mantenidos en la fecha de referencia. Example: 100 - `results.investment.balance.gross_unit_price` (number,null) El valor bruto unitario actual de la inversión en la fecha de referencia Example: 10 - `results.investment.balance.net_value` (number,null) El valor neto de la inversión después de deducciones por impuestos, tarifas y otros cargos, a la fecha de referencia. Example: 900 - `results.investment.balance.withheld_amount` (number,null) La cantidad del instrumento de inversión que ha sido retenida o deducida del valor neto. Example: 10 - `results.investment.balance.transaction_fee` (number,null) Las tarifas e impuestos cobrados por la transacción. Example: 5 - `results.investment.balance.purchase_unit_price` (number,null) El precio unitario en el momento de la compra del valor o activo. Example: 10 - `results.investment.balance.pre_fixed_rate` (number,null) La tasa de remuneración prefijada para el producto de ingresos. Example: 0.05 - `results.investment.balance.post_fixed_rate` (number,null) El porcentaje del indexador post-fijado para el producto de ingresos. Example: 0.05 - `results.investment.balance.penalty_fee` (number,null) La penalización (multa) por retrasos en los pagos, tal como se define en el contrato. Example: 10 - `results.investment.balance.late_payment_fee` (number,null) El interés cobrado por pagos atrasados. Example: 10 - `results.investment.balance.closing_price` (number,null) El precio de cierre de la inversión en la fecha de referencia. Example: 10 - `results.investment.balance.unit_price_factor` (number,null) El factor utilizado para calcular el precio unitario. Example: 1 - `results.investment.remuneration` (object) Los detalles de la remuneración del instrumento de inversión. - `results.investment.remuneration.pre_fixed_rate` (number,null) La tasa de interés fija definida en la emisión, expresada como un decimal (por ejemplo, representa el 15%). Example: 0.05 - `results.investment.remuneration.post_fixed_rate` (number,null) La tasa de interés post-fijada definida en la emisión, expresada como un decimal (por ejemplo, representa el 15%). Example: 0.05 - `results.investment.remuneration.rate_type` (string,null) El tipo de tasa de remuneración aplicada al instrumento financiero. Puede ser: - - Example: "LINEAR" - `results.investment.remuneration.rate_periodicity` (string,null) La frecuencia con la que se aplica la tasa de remuneración al instrumento financiero. Puede ser: - - - - Example: "MENSAL" - `results.investment.remuneration.calculation_base` (string,null) Indica si el cálculo de la remuneración o de los intereses se basa en días hábiles () o días calendario (). - - Example: "DIAS_CORRIDOS" - `results.investment.remuneration.indexer` (string,null) El índice utilizado como referencia para calcular la rentabilidad o los rendimientos del instrumento financiero. Puede ser uno de los siguientes: - - - - - - - - - - - - Example: "CDI" - `results.investment.remuneration.indexer_additional_info` (string,null) Información adicional sobre la tasa de . Requerido cuando está configurado en . Example: "IPCA + 5%" - `results.investment.classification_details` (object,null) Los detalles de clasificación del instrumento de inversión. > 🚧 Solo aplicable para inversiones de tipo . > > Este objeto solo es aplicable para inversiones de tipo . Para todos los demás tipos de inversión, este objeto será . - `results.investment.classification_details.category` (string,null) La categoría del fondo de inversión, según los estándares de clasificación de ANBIMA. Puede ser una de las siguientes: - - - - Example: "ACOES" - `results.investment.classification_details.class` (string,null) La clase dentro de la categoría del fondo de inversión, según los estándares de clasificación de ANBIMA. Example: "Ações Livre" - `results.investment.classification_details.subclass` (string,null) La subclase del fondo de inversión, según los estándares de clasificación de ANBIMA. Example: "Ações Livre" - `results.investment.voucher_payment_details` (object) Los detalles del pago del voucher (también conocido como pagos de cupón) del instrumento de inversión. > 🚧 Solo aplicable para inversiones de tipo y . > > Este objeto solo es aplicable para inversiones de tipo y . Para todos los demás tipos de inversión, este objeto será . - `results.investment.voucher_payment_details.is_voucher_payment` (boolean) Indica si el instrumento financiero paga intereses periódicos (pagos de cupones). Example: true - `results.investment.voucher_payment_details.periodicity` (string,null) La frecuencia con la que se realizan los pagos del voucher. Requerido cuando está configurado como . Puede ser uno de los siguientes: - - - - - - Example: "MENSAL" - `results.investment.voucher_payment_details.periodicity_additional_info` (string,null) Información adicional sobre la periodicidad del pago del vale. Requerido cuando está configurado como . Example: "30/360" - `results.investment.debtor_details` (object,null) Los detalles del deudor del instrumento de inversión. > 🚧 Solo aplicable para inversiones de tipo . > > Este objeto solo es aplicable para inversiones de tipo . Para todos los demás tipos de inversión, este objeto será . - `results.investment.debtor_details.name` (string) El nombre del deudor. Example: "Roberto Marino" - `results.investment.debtor_details.id_document_number` (string) El número del documento de identificación del deudor (CNPJ). Example: 12345678901 - `results.internal_identification` (string) La identificación interna de la institución de la transacción de inversión. Example: "ABCD2126019929279212650822221989319253344" - `results.value_date` (string) La fecha en la que se liquidó la transacción, en formato . > 📘 > > Para inversiones de , solo recibirás transacciones hasta la última fecha de negociación. Por ejemplo, si hoy es 19.11.2024, solo recibirás transacciones hasta el 18.11.2024. > 📘 > > Para inversiones de , esta es la fecha en la que la transacción (compra o rescate) se procesa oficialmente en acciones o cuotas del fondo. Para compras, esta es la fecha en la que el dinero del inversor se aplica para adquirir acciones del fondo. Para rescates, esta es la fecha en la que las acciones del fondo se convierten oficialmente de nuevo en efectivo. Example: "2024-11-18" - `results.gross_value` (number) El valor bruto de la transacción. > 🚧 No aplicable para inversiones de . Example: 60 - `results.net_value` (number) El valor neto de la transacción. > 🚧 No aplicable para inversiones de . Example: 60 - `results.value` (number) El valor de la transacción. Para inversiones de , este es el valor de la operación ejecutada por el cliente. Si el cliente compra o vende acciones, este campo indica el valor total de la operación (por ejemplo, el precio por acción × cantidad). Para inversiones de , este es el valor solicitado por el cliente para una transacción de fondo. > 🚧 Solo aplicable para inversiones de y . Example: 60 - `results.unit_price` (number) El precio por una unidad o cuota individual. Example: 3 - `results.price_factor` (number) El número de unidades (acciones) considerado al calcular el precio por acción o unidad para una transacción. > 🚧 Solo aplicable para inversiones de . Example: 1 - `results.transaction_tax` (number) El Impuesto sobre Operaciones Financieras () aplicado o retenido durante la transacción. > 🚧 No aplicable para inversiones de . - `results.income_tax` (number) El Impuesto sobre la Renta () aplicado o retenido durante la transacción. > 🚧 No aplicable para inversiones de . - `results.quantity` (number) El número de unidades, cuotas o activos involucrados en una transacción. Example: 20 - `results.type` (string) El tipo de transacción ( o ) desde la perspectiva de la inversión. Enum: "INFLOW", "OUTFLOW", "null" - `results.subtype` (string) El subtipo de transacción. - Para : APLICACAO, RESGATE, CANCELAMENTO, VENCIMENTO, PAGAMENTO_JUROS, AMORTIZACAO, TRANSFERENCIA_TITULARIDADE, TRANSFERENCIA_CUSTODIA, OUTROS. - Para : COMPRA, VENDA, CANCELAMENTO, VENCIMENTO, PAGAMENTO_JUROS, AMORTIZACAO, PRÊMIO, TRANSFERENCIA_TITULARIDADE, TRANSFERENCIA_CUSTODIA, MULTA, MORA, OUTROS. - Para : COMPRA, VENDA, DIVIDENDOS, JCP, ALUGUEIS, TRANSFERENCIA_TITULARIDADE, OUTROS. - Para : AMORTIZACAO, TRANSFERENCIA_DE_COTAS, APLICACAO, RESGATE, COME_COTAS, OUTROS. - Para : COMPRA, VENDA, CANCELAMENTO, VENCIMENTO, PAGAMENTO_JUROS, AMORTIZACAO, TRANSFERENCIA_TITULARIDADE, TRANSFERENCIA_CUSTODIA, OUTROS. - `results.subtype_additional_info` (string) Información adicional sobre el subtipo de transacción. Este campo es obligatorio cuando el subtipo es . - `results.indexer_percentage` (number) El porcentaje máximo del indexador para el contrato (Bancaria) o transacción (Crédito). > 🚧 Solo aplicable para inversiones en y . - `results.rate` (number) La tasa de remuneración aplicada a la transacción. > 🚧 Solo aplicable para inversiones en , y . - `results.exit_fee` (number) La tarifa de salida se aplica a la transacción del Fondo de Inversión (Fundos de Investimento). Esta tarifa se cobra cuando un cliente rescata o sale del fondo. > 🚧 Solo aplicable para inversiones de tipo . - `results.broker_note_details` (object,null) Detalles sobre la nota de corretaje asociada con esta transacción. Este objeto solo se devuelve para transacciones que están asociadas con un tipo de inversión . > 📘 Info > > Una nota de corretaje () es un documento oficial emitido por una correduría que detalla las transacciones realizadas por un inversor en un día determinado. Incluye información sobre el valor bruto de todas las compras y ventas, comisiones de corretaje, tarifas de compensación y liquidación, tarifas de compensación y registro, tarifas de aviso de negociación de activos en bolsa, tarifas de bolsa, tarifas de custodia de compensación, impuestos y el impuesto sobre la renta retenido en la fuente. - `results.broker_note_details.broker_note_number` (string, required) El número de la nota del broker. Example: "1854009930314350" - `results.broker_note_details.gross_value` (number, required) El valor bruto de todas las compras y ventas del día. Example: 1000 - `results.broker_note_details.brokerage_fee` (number, required) La tarifa total de corretaje cobrada por el día. Example: 10 - `results.broker_note_details.clearing_settlement_fee` (number, required) La tarifa cobrada por la compensación y liquidación en custodia. Example: 2.5 - `results.broker_note_details.clearing_registration_fee` (number, required) La tarifa cobrada por la compensación y el registro en custodia. Example: 1 - `results.broker_note_details.stock_exchange_asset_trade_notice_fee` (number, required) La tarifa cobrada por la bolsa de valores por las notificaciones de comercio de activos. Example: 0.5 - `results.broker_note_details.stock_exchange_fee` (number, required) La tarifa cobrada por la bolsa de valores por los servicios de registro. Example: 3 - `results.broker_note_details.clearing_custody_fee` (number, required) La tarifa cobrada por las instituciones financieras por los servicios de custodia. Example: 1.5 - `results.broker_note_details.taxes` (number, required) El monto total de los impuestos cobrados en la transacción del día, excluyendo el impuesto sobre la renta retenido en la fuente. Example: 10 - `results.broker_note_details.income_tax` (number, required) El monto total del impuesto sobre la renta retenido en la fuente para el día. Example: 5 - `results.broker_note_details.net_value` (number, required) El valor neto de la nota del corredor después de deducir los gastos por comisiones de corretaje, tarifas de liquidación de compensación, tarifas de registro, tarifas de ANA, emolumentos, tarifas de custodia, impuestos y IRRF. Example: 980 ## Response 403 fields (application/json): - `code` (string) Un código de error único () que te permite clasificar y manejar el error de manera programática. ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar 403 access_to_resource_denied. Example: "access_to_resource_denied" - `message` (string) Una breve descripción del error. Para los errores , la descripción es: - . Example: "You don't have access to this resource." - `request_id` (string) Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 404 fields (application/json): - `code` (string) Un código de error único () que te permite clasificar y manejar el error de manera programática. Example: "not_found" - `message` (string) Una breve descripción del error. Para errores , la descripción es: - Example: "Not found" - `request_id` (string) Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 408 fields (application/json): - `code` (string) Un código de error único () que te permite clasificar y manejar el error de manera programática. ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 408 request_timeout. Example: "request_timeout" - `message` (string) Una breve descripción del error. Para los errores de , la descripción es: - . Example: "The request timed out, you can retry asking for less data by changing your query parameters" - `request_id` (string) Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones. Example: "9e7b283c6efa449c9c028a16b5c249fb" ## Response 500 fields (application/json): - `code` (string) Un código de error único () que te permite clasificar y manejar el error de manera programática. ℹ️ Consulta nuestro DevPortal para obtener más información sobre cómo manejar errores 500 unexpected_error. Example: "unexpected_error" - `message` (string) Una breve descripción del error. Para los errores , la descripción es: - . Example: "Belvo is unable to process the request due to an internal system issue or to an unsupported response from an institution" - `request_id` (string) Un ID único de 32 caracteres de la solicitud (que coincide con un patrón regex de: ). Proporcione este ID al contactar al equipo de soporte de Belvo para acelerar las investigaciones. Example: "9e7b283c6efa449c9c028a16b5c249fb"