# Obtener los detalles de una cuenta Obtener los detalles de una cuenta específica. {% admonition type="info" %} Este recurso puede devolver campos obsoletos. Por favor, consulte la documentación de la respuesta para más información. {% /admonition %} Endpoint: GET /api/accounts/{id}/ Version: 1.223.0 Security: basicAuth ## Path parameters: - `id` (string, required) El sobre el cual deseas obtener información detallada. ## Query parameters: - `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. ## Response 200 fields (application/json): - `id` (string, required) Identificador único de Belvo para el elemento actual. Example: "0d3ffb69-f83b-456e-ad8e-208d0998d71d" - `link` (string,null, required) El al que pertenecen los datos. Example: "30cb4806-6e00-48a4-91c9-ca55968576c8" - `institution` (object, required) Detalles sobre la institución. - `institution.name` (string) El nombre de la institución, según lo designado por Belvo. Example: "erebor_mx_retail" - `institution.type` (string) El tipo de institución. Devolvemos uno de los siguientes valores: - - - Enum: "bank", "fiscal", "employment" - `collected_at` (string, required) La marca de tiempo ISO-8601 cuando se recopiló el punto de datos. Example: "2022-02-09T08:45:50.406032Z" - `created_at` (string, required) 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" - `last_accessed_at` (string,null, required) La marca de tiempo ISO-8601 del acceso más reciente y exitoso de Belvo a la institución para el enlace dado. Example: "2021-03-09T10:28:40.000Z" - `category` (string,null, required) El tipo de cuenta. Devolvemos uno de los siguientes valores de enum: - - - - - - - - - - Enum: "ADVANCE_DEPOSIT_ACCOUNT", "CHECKING_ACCOUNT", "CREDIT_CARD", "FINANCING_ACCOUNT", "INVESTMENT_ACCOUNT", "INVOICE_FINANCING_ACCOUNT", "LOAN_ACCOUNT", "PENSION_FUND_ACCOUNT", "SAVINGS_ACCOUNT", "UNCATEGORIZED" - `balance_type` (string,null, required) Indica si esta cuenta es un o un . Puedes considerar el saldo de un como positivo, mientras que el saldo de un como negativo. Example: "ASSET" - `overdraft` (object,null) - `overdraft.arranged` (number, required) El límite de sobregiro acordado entre el titular de la cuenta y la institución. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: 5000.5 - `overdraft.used` (number, required) El valor del sobregiro utilizado. > La red de finanzas abiertas de Brasil debe devolver un valor si el campo está disponible. Example: 1000.5 - `overdraft.unarranged` (number, required) El sobregiro utilizado que no fue acordado entre el titular de la cuenta y la institución. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: 300.1 - `type` (string, required) El tipo de cuenta, según lo designado por la institución. > La red de finanzas abiertas de Brasil debe devolver un valor. Example: "STANDARD_NACIONAL" - `subtype` (string, required) El subtipo de cuenta, según lo designado por la institución. > La red de finanzas abiertas de Brasil debe devolver un valor. Example: "FINANCIAMENTO_HABITACIONAL_SFH" - `name` (string,null, required) El nombre de la cuenta, tal como lo proporciona la institución. Example: "Cuenta Perfiles- M.N. - MXN-666" - `number` (string,null, required) El número de cuenta, tal como lo designa la institución. Example: "4057068115181" - `agency` (string,null, required) El código de sucursal donde se abrió el producto. Example: "6272" - `check_digit` (string,null, required) El dígito de control del número del producto, si corresponde. Example: "7" - `balance` (object, required) Detalles sobre los saldos actual y disponible de la cuenta. - `balance.current` (number,null, required) El saldo actual se calcula de manera diferente según el tipo de cuenta. - : El saldo de la cuenta del usuario en el momento del timestamp . - : La cantidad que el usuario ha gastado en el período de facturación actual de la tarjeta (consulte para obtener información sobre cuándo finaliza el período de facturación actual). - : La cantidad restante por pagar en el préstamo del usuario. Example: 5874.13 - `balance.available` (number,null) El saldo que el titular de la cuenta puede utilizar. - : El saldo disponible puede ser diferente al saldo debido a transacciones pendientes. - : El monto de crédito que el usuario aún tiene disponible para el período actual. El monto se calcula como menos . - : El valor presente requerido para liquidar el préstamo, según lo proporcionado por la institución. Si la institución no proporciona este valor, devolvemos . Example: 5621.12 - `balance.blocked` (number) La cantidad que está actualmente bloqueada debido a transacciones pendientes. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: 60.32 - `balance.automatically_invested` (number) La cantidad que se invierte automáticamente (según lo acordado con la institución). > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: 131.5 - `currency` (string, required) El código de moneda de tres letras (ISO-4217). > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: "BRL" - `public_identification_name` (string,null, required) El nombre público para el tipo de identificación. Para cuentas de ahorro y corrientes en 🇧🇷 Brasil, este campo será . Example: "AGENCY/ACCOUNT" - `public_identification_value` (string,null, required) El valor para el . Para cuentas de ahorro y corriente OFDA brasileñas 🇧🇷, este campo será el número de agencia y cuenta bancaria, separados por una barra. Por ejemplo: . Para cuentas de tarjeta de crédito OFDA brasileñas 🇧🇷, devolveremos una cadena de números de tarjeta de crédito concatenados asociados con la cuenta. Por ejemplo: "8763,9076,5522" Example: "0444/45722-0" - `internal_identification` (string, required) La identificación interna de la institución para la cuenta. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: "92792126019929279212650822221989319252576" - `credit_data` (object,null, required) Detalles sobre las tarjetas de crédito asociadas con esta cuenta. - `credit_data.credit_limit` (number,null, required) El límite de crédito superior de la tarjeta. > La red de finanzas abiertas de Brasil debe devolver un valor. Example: 192000.9 - `credit_data.limits` (array) - `credit_data.limits.identification_number` (string,null, required) El número de la tarjeta de crédito. A menudo, esto es solo los últimos cuatro dígitos de la tarjeta de crédito. > La red de finanzas abiertas de Brasil debe devolver un valor. Example: "4453" - `credit_data.limits.credit_limit` (number,null, required) El límite de la tarjeta de crédito. Example: 1000.04 - `credit_data.limits.used_amount` (number,null, required) La cantidad utilizada. Example: 400.04 - `credit_data.limits.available_amount` (number, required) El monto aún disponible. > La red de finanzas abiertas de Brasil debe devolver un valor. Example: 600 - `credit_data.limits.is_limit_flexible` (boolean, required) Boolean para indicar si el es flexible. > La red de finanzas abiertas de Brasil debe devolver un valor. - `credit_data.limits.type` (string, required) El tipo de límite. Devolvemos uno de los siguientes valores: - - > La red de finanzas abiertas de Brasil debe devolver un valor. Enum: "TOTAL_LIMIT", "MODAL_LIMIT" - `credit_data.limits.consolidation_type` (string, required) Indica si el límite de crédito es consolidado o individual. > La red de finanzas abiertas de Brasil debe devolver un valor. Example: "INDIVIDUAL" - `credit_data.limits.line_name` (string,null, required) El nombre de la línea de límite de crédito. Example: "CREDITO_A_VISTA" - `credit_data.limits.line_name_additional_info` (string,null, required) Información adicional sobre el nombre de la línea. Example: "Informações adicionais e complementares" - `credit_data.cutting_date` (string,null) La fecha de vencimiento de la factura de la tarjeta de crédito. Example: "2019-12-11" - `credit_data.minimum_payment` (number,null) La cantidad mínima que el titular de la cuenta necesita pagar en el período de crédito actual. Example: 2400.3 - `credit_data.network` (string) La red de crédito con la que está asociada la tarjeta. Devolvemos uno de los siguientes valores: - - - - - - - - - > La red de finanzas abiertas de Brasil debe devolver un valor. Enum: "VISA", "MASTERCARD", "AMERICAN_EXPRESS", "DINERS_CLUB", "HIPERCARD", "BANDEIRA_PROPRIA", "CHEQUE_ELETRONICO", "ELO", "OTHER" - `credit_data.network_additional_info` (string,null) Información adicional sobre la red de tarjetas de crédito. Example: "It's an orange card." - `credit_data.cards` (array) Detalles sobre las tarjetas asociadas con la cuenta. - `credit_data.cards.is_multiple` (boolean, required) Boolean para indicar si esta cuenta tiene múltiples tarjetas de crédito. > La red de finanzas abiertas de Brasil debe devolver un valor. - `credit_data.next_payment_date` (string,null) Este campo no es aplicable para OF Brazil y devolverá null. - `credit_data.no_interest_payment` (number,null) Este campo no es aplicable para OF Brazil y devolverá null. - `credit_data.interest_rate` (number,null) Este campo no es aplicable para OF Brazil y devolverá null. - `credit_data.monthly_payment` (number,null) Este campo no es aplicable para OF Brazil y devolverá null. - `credit_data.last_payment_date` (string,null) Este campo no es aplicable para OF Brazil y devolverá null. - `loan_data` (object,null, required) Las opciones de préstamo asociadas con esta cuenta. - `loan_data.loan_code` (string, required) El número de contrato estandarizado específico del país. > La red de finanzas abiertas de Brasil debe devolver un valor. Example: "92792126019929279212650822221989319252576" - `loan_data.contract_amount` (number,null, required) El monto total inicial del préstamo cuando se firmó el contrato, calculado por la institución. Este monto incluye el principal + intereses + impuestos + tarifas. Example: 202000 - `loan_data.total_effective_cost` (number,null) El costo total efectivo inicial del préstamo. Example: 209000 - `loan_data.loan_type` (string, required) El tipo de préstamo, según la institución. > La red de finanzas abiertas de Brasil debe devolver un valor. Example: "HOME_EQUITY" - `loan_data.outstanding_balance` (number,null, required) El monto restante a pagar en total, incluidos los intereses. Example: 182000 - `loan_data.interest_rates` (array, required) Desglose del interés aplicado al préstamo. Con OF Brasil, recomendamos encarecidamente utilizar la información en para obtener información detallada. > La red de finanzas abiertas de Brasil debe devolver un valor. - `loan_data.interest_rates.name` (string,null, required) El nombre del tipo de tasa de interés aplicada al préstamo. Para OFDA Brasil, recomendamos usar el parámetro . Example: "NOMINAL" - `loan_data.interest_rates.type` (string, required) El período durante el cual se aplica el interés al préstamo. > La red de finanzas abiertas de Brasil debe devolver un valor. Enum: "MONTHLY", "YEARLY" - `loan_data.interest_rates.value` (number,null, required) La tasa de interés (en porcentaje o valor monetario). Para OFDA Brasil, recomendamos usar el parámetro y . Example: 7.85 - `loan_data.interest_rates.interest_rate_data` (object,null, required) Información detallada sobre la tasa de interés. - `loan_data.interest_rates.interest_rate_data.tax_type` (string, required) El tipo de impuesto sobre la tasa de interés. Devolvemos uno de los siguientes valores: - - > La red de finanzas abiertas de Brasil debe devolver un valor. Enum: "NOMINAL", "EFFECTIVE" - `loan_data.interest_rates.interest_rate_data.rate_type` (string, required) El tipo de tasa de interés. Devolvemos uno de los siguientes valores: - - > La red de finanzas abiertas de Brasil debe devolver un valor. Enum: "SIMPLE", "COMPOUND" - `loan_data.interest_rates.interest_rate_data.calculation_base` (string, required) El cálculo base para la tasa de interés. > La red de finanzas abiertas de Brasil debe devolver un valor. Example: "30/360" - `loan_data.interest_rates.interest_rate_data.reference_index_type` (string, required) La tasa de índice de referencia. Devolvemos uno de los siguientes valores: - - - - - - - > La red de finanzas abiertas de Brasil debe devolver un valor. Enum: "WITHOUT_INDEX_TYPE", "PRE_FIXED", "POST_FIXED", "FLOATING", "INDEXED_PRICE", "RURAL_CREDIT", "OTHER_INDEX" - `loan_data.interest_rates.interest_rate_data.reference_index_subtype` (string,null, required) El subtipo de la tasa de índice de referencia. Example: "TR_TBF" - `loan_data.interest_rates.interest_rate_data.reference_index_info` (string,null, required) Información adicional sobre la tasa del índice de referencia. Example: "Additional information" - `loan_data.interest_rates.interest_rate_data.pre_fixed_rate` (number, required) La tasa de interés con porcentaje prefijado. > La red de finanzas abiertas de Brasil debe devolver un valor. Example: 0.062 - `loan_data.interest_rates.interest_rate_data.post_fixed_rate` (number, required) La tasa de porcentaje post-fijada de la tasa de interés. > La red de finanzas abiertas de Brasil debe devolver un valor. Example: 0.062 - `loan_data.interest_rates.interest_rate_data.additional_info` (string,null, required) Información adicional sobre la tasa de interés. Example: "Additional information" - `loan_data.fees` (array,null, required) Desglose de las tarifas aplicadas al préstamo. - `loan_data.fees.type` (string,null, required) Este campo no es aplicable para OF Brazil y devolverá null. Enum: "OPERATION_FEE", "INSURANCE_FEE", "OTHERS", null - `loan_data.fees.value` (number,null, required) El valor total de la tarifa. Misma moneda que el préstamo. Example: 5.6 - `loan_data.fees.name` (string, required) El nombre de la tarifa. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: "Renovação de cadastro" - `loan_data.fees.code` (string, required) El código de tarifa. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: "CADASTRO" - `loan_data.fees.fee_charge_type` (string, required) Indica el tipo de cargo. Devolvemos uno de los siguientes valores: - - > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Enum: "SINGLE", "PER_INSTALLMENT" - `loan_data.fees.fee_charge` (string, required) Método de facturación, según lo acordado con la institución. Devolvemos uno de los siguientes valores: - - - - > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Enum: "MINIMUM", "MAXIMUM", "FIXED", "PERCENTAGE" - `loan_data.fees.rate` (number,null, required) La tasa porcentual de la tarifa. Requerido cuando está configurado en . Example: 0.062 - `loan_data.contracted_charges` (array,null) Lo siento, no hay texto proporcionado para traducir. Por favor, proporciona el texto que necesitas que traduzca. - `loan_data.contracted_charges.type` (string) El tipo de cargo contratado. Devolvemos uno de los siguientes valores: - - - - - - - > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Enum: "LATE_PAYMENT_INTEREST_FEE", "LATE_PAYMENT_PENALTY_FEE", "DEFAULT_INTEREST_FEE", "LOAN_CONTRACT_TAX", "LATE_PAYMENT_TAX", "NO_CHARGE", "OTHER" - `loan_data.contracted_charges.info` (string,null) Información adicional sobre el cargo contratado. Example: "Late fee" - `loan_data.contracted_charges.rate` (number,null) La tasa porcentual del cargo, calculada en función del monto del préstamo. Example: 0.062 - `loan_data.collaterals` (array,null, required) Detalles sobre cualquier garantía de préstamo que el individuo o negocio haya proporcionado. - `loan_data.collaterals.type` (string, required) El tipo de garantía, según lo definido por la institución. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: "OPERACOES_GARANTIDAS_PELO_GOVERNO" - `loan_data.collaterals.subtype` (string, required) El subtipo de la garantía, según lo definido por la institución. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: "CCR_CONVENIO_CREDITOS_RECIPROCOS" - `loan_data.collaterals.amount` (number, required) El monto total de la factura. > Se debe devolver un valor por la red de finanzas abiertas de Brasil si el campo está disponible. Example: 45391.89 - `loan_data.balloon_payments` (array,null, required) Información detallada sobre cualquier pago global del préstamo, si corresponde. - `loan_data.balloon_payments.due_date` (string,null, required) La fecha en que se debe pagar el balloon payment, en formato . Example: "2021-09-06" - `loan_data.balloon_payments.currency` (string,null, required) El código de moneda de tres letras (ISO-4217). Example: "BRL" - `loan_data.balloon_payments.amount` (number,null, required) El monto total del pago global. Example: 45391.89 - `loan_data.installments_contract_term_frequency` (string,null, required) La frecuencia de los pagos a plazos contratados, tal como se definió cuando se firmó el contrato por primera vez. Devolvemos uno de los siguientes: - - - - - - Enum: "DAY", "WEEK", "MONTH", "YEAR", "NO_DEADLINE_REMAINING", null - `loan_data.installment_frequency` (string, required) La frecuencia con la que se pagan las cuotas. Devolvemos uno de los siguientes valores: - - - - - - - - - > La red de finanzas abiertas de Brasil debe devolver un valor. Enum: "IRREGULAR", "WEEKLY", "FORTNIGHTLY", "MONTHLY", "BIMONTHLY", "QUARTERLY", "BIANNUALLY", "ANNUALLY", "OTHER" - `loan_data.installment_frequency_info` (string,null, required) Información adicional sobre el . Example: "Both the term and requency are the same." - `loan_data.first_installment_due_date` (string,null, required) La fecha en la que debe pagarse la primera cuota del préstamo, en formato . Example: "2020-03-01" - `loan_data.number_of_installments_total` (integer,null, required) El número total de cuotas necesarias para pagar el préstamo. Example: 60 - `loan_data.number_of_installments_outstanding` (integer,null, required) El número de cuotas restantes por pagar. Example: 48 - `loan_data.number_of_installments_paid` (integer,null, required) El número de cuotas ya pagadas. Example: 32 - `loan_data.number_of_installments_past_due` (integer,null, required) El número de cuotas que están vencidas. Example: 2 - `loan_data.disbursement_dates` (array,null, required) Un array de fechas cuando se desembolsó el préstamo. Example: ["2021-09-23"] - `loan_data.settlement_date` (string,null, required) La fecha en que se liquidó el préstamo, en formato . Example: "2021-09-23" - `loan_data.contract_start_date` (string, required) La fecha en que se firmó el contrato de préstamo, en formato . > Se debe devolver un valor por la red de finanzas abiertas de Brasil. Example: "2020-03-01" - `loan_data.contract_end_date` (string,null, required) La fecha en la que se espera que el préstamo se complete, en formato . Example: "2027-10-01" - `loan_data.contract_remaining_frequency` (string,null, required) La frecuencia de los pagos de las cuotas restantes contratadas, tal como se definió cuando se firmó el contrato por primera vez. Devolvemos uno de los siguientes valores: - - - - - - Enum: "DAY", "WEEK", "MONTH", "YEAR", "NO_DEADLINE_REMAINING", null - `loan_data.contract_remaining_total` (integer,null, required) El número total de cuotas restantes del préstamo. Example: 20 - `loan_data.amortization_schedule` (string, required) El calendario de amortización del préstamo. > La red de finanzas abiertas de Brasil debe devolver un valor. Example: "SEM_SISTEMA_AMORTIZACAO" - `loan_data.amortization_schedule_info` (string,null, required) Información adicional sobre el . Example: "No need for a schedule." - `loan_data.consignee_id` (string,null, required) El ID del consignatario del préstamo. Example: "60500998000135" - `loan_data.contract_number` (string,null, required) El número de contrato del préstamo, tal como lo proporciona la institución. Example: "1324926521496" - `loan_data.principal` (number,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `loan_data.payment_day` (string,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `loan_data.outstanding_principal` (number,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `loan_data.credit_limit` (number,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `loan_data.last_period_balance` (number,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `loan_data.limit_day` (string,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `loan_data.cutting_day` (string,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `loan_data.cutting_date` (string,null, required) Este campo no es aplicable para OF Brazil y devolverá null. - `funds_data` (string,null, required) Este campo no es aplicable para OF Brazil y devolverá null. ## 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"