Obtener suscripción a plan de ahorro

Para obtener el detalle de una suscripción a un plan de ahorro se debe realizar el siguiente request:

GET/v1/savings/account-investment-plans/{account_investment_plan_id}

Request

Headers

Campo	Tipo	Requerido	Descripción
Authorization	string	Sí	Token de acceso en formato Bearer ACCESS_TOKEN

Path Parameters

Campo	Tipo	Requerido	Descripción
account_investment_plan_id	number	Sí	Identificador de la suscripción.

No aplica: Query Parameters, Body.

Response

2XX Éxito

Campo	Tipo	Descripción
id	number	Identificador de la suscripción.
account_number	number	Número de cuenta asociada.
subscription_name	string	Nombre de la suscripción.
plan_code	string	Código del plan.
plan_name	string	Nombre del plan.
amount	number | null	Monto periódico de la suscripción.
cbu	number | null	CBU asociado al DEBIN.
status	string	Estado actual de la suscripción. Ver Valores de estado a continuación.
debin_window	string | null	Ventana de cobro del DEBIN. Valores permitidos: FIRST_PERIOD (días 1–10), SECOND_PERIOD (días 11–20), THIRD_PERIOD (días 21–31).
adjust_by_ipc	boolean	Indica si el monto se ajusta por IPC.
target_amount	number	Monto objetivo del plan.
created_at	string	Fecha y hora de creación de la suscripción.
total_performance	object	Rendimiento total acumulado.
total_performance.currency	string	Moneda del rendimiento.
total_performance.total_deposits	number	Total depositado.
total_performance.total_withdrawals	number	Total retirado.
total_performance.net_contributions	number	Contribuciones netas.
total_performance.current_value	number	Valor actual de la suscripción.
total_performance.total_performance	number	Rendimiento total en términos absolutos.
total_performance.total_performance_percentage	number	Rendimiento total en porcentaje.
monthly_performance	object	Rendimiento del período mensual actual.
monthly_performance.currency	string	Moneda del rendimiento.
monthly_performance.period_start	string	Inicio del período.
monthly_performance.period_end	string	Fin del período.
monthly_performance.monthly_performance	number	Rendimiento mensual en términos absolutos.
monthly_performance.monthly_performance_percentage	number	Rendimiento mensual en porcentaje.
next_debin_date	string | null	Fecha estimada del próximo DEBIN.

Valores de estado

Valor	Descripción
ACTIVE	La suscripción está activa y operando con normalidad.
AWAITING_BIND	Esperando que el usuario apruebe la recurrencia de débito directo DEBIN en su aplicación bancaria.
PAUSED_BY_CONSECUTIVE_ERRORS_DEBIN	Pausada automáticamente tras tres fallas consecutivas de DEBIN. Allaria cancela la suscripción si este estado persiste.
PAUSED_BY_USER	Pausada a pedido del usuario.
AWAITING_ASSET_TRANSFER	Una liberación o retiro está en curso; las cuotapartes están siendo transferidas.
AWAITING_ASSET_WITHDRAWAL	Las cuotapartes están siendo liquidadas a efectivo.
AWAITING_CASH_TRANSFER	La transferencia de efectivo al CVU de destino está en curso.
CLAIMED	Todas las cuotapartes fueron transferidas al partner. La suscripción está cerrada.
WITHDRAWN	Todos los fondos fueron devueltos al CVU del usuario. La suscripción está cerrada.
BIND_ACTIVATION_FAILED	La suscripción de recurrencia DEBIN expiró sin aprobación del usuario.

Códigos de error

Los errores devuelven el siguiente body:

{
  "code": "invalid_request",
  "description": "Descripción del error."
}

Status	Code	Condición
400	invalid_request	La suscripción especificada no existe.
403	—	El token no tiene el rol requerido o la cuenta no es accesible.

Ejemplo de código

cURL

curl -X GET https://b2b.allaria.cloud/v1/savings/account-investment-plans/1 \
  -H "Authorization: Bearer ACCESS_TOKEN"

JavaScript

const accountInvestmentPlanId = 1;

const response = await fetch(
  `https://b2b.allaria.cloud/v1/savings/account-investment-plans/${accountInvestmentPlanId}`,
  {
    method: 'GET',
    headers: {
      'Authorization': 'Bearer ACCESS_TOKEN'
    }
  }
);

const data = await response.json();
console.log(data);

Python

import requests

account_investment_plan_id = 1

response = requests.get(
  f'https://b2b.allaria.cloud/v1/savings/account-investment-plans/{account_investment_plan_id}',
  headers={
    'Authorization': 'Bearer ACCESS_TOKEN'
  }
)

data = response.json()
print(data)

Node.js

const axios = require('axios');

const accountInvestmentPlanId = 1;

const response = await axios.get(
  `https://b2b.allaria.cloud/v1/savings/account-investment-plans/${accountInvestmentPlanId}`,
  {
    headers: {
      Authorization: 'Bearer ACCESS_TOKEN'
    }
  }
);

console.log(response.data);

2XX Éxito

{
  "id": 6,
  "account_number": 70,
  "subscription_name": "test",
  "plan_code": "MEDIUM_ARS",
  "plan_name": "Plan Mediano Plazo en ARS",
  "amount": null,
  "cbu": null,
  "status": "ACTIVE",
  "debin_window": null,
  "adjust_by_ipc": false,
  "target_amount": 10000.00,
  "created_at": "2026-04-14T11:38:42",
  "total_performance": {
    "currency": "ARS",
    "total_deposits": 0,
    "total_withdrawals": 0,
    "net_contributions": 0,
    "current_value": 0,
    "total_performance": 0,
    "total_performance_percentage": 0
  },
  "monthly_performance": {
    "currency": "ARS",
    "period_start": "2026-04-01T00:00:00",
    "period_end": "2026-04-14T12:03:01.544027",
    "monthly_performance": 0,
    "monthly_performance_percentage": 0
  },
  "next_debin_date": null
}