> ## Documentation Index
> Fetch the complete documentation index at: https://docs.yampi.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# List Treasury Subscriptions

> Lista las suscripciones de tesorería de la cuenta.

Devuelve todas las suscripciones de tesorería asociadas a la cuenta, con paginación implícita. Opcionalmente filtra por estado.

## Autenticación

<ParamField header="api_access_token" type="string" required>
  Token de usuario (**userApiKey**).
</ParamField>

## Parámetros de ruta

<ParamField path="account_id" type="integer" required>
  ID de la cuenta.
</ParamField>

## Parámetros de consulta

<ParamField query="status" type="string">
  Filtra por estado de la suscripción (opcional).
</ParamField>

## Ejemplo de solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET 'https://app.yampi.ai/api/v1/accounts/1/treasury/subscriptions?status=active' \
    -H 'api_access_token: TU_TOKEN' \
    -H 'Content-Type: application/json'
  ```
</RequestExample>

## Respuesta exitosa

<ResponseExample>
  ```json 200 - Success theme={null}
  [
    {
      "id": 1,
      "account_id": 1,
      "status": "active",
      "tenant_contact_id": 5,
      "property_tenancy_id": 12,
      "amount": 1500000,
      "currency": "COP",
      "started_at": "2026-01-01",
      "ended_at": null,
      "created_at": "2026-01-01T00:00:00Z",
      "updated_at": "2026-03-13T00:00:00Z"
    }
  ]
  ```
</ResponseExample>

<ResponseField name="[].id" type="number">
  ID de la suscripción.
</ResponseField>

<ResponseField name="[].amount" type="number">
  Monto de la suscripción.
</ResponseField>

<ResponseField name="[].currency" type="string">
  Código de moneda (ej. COP).
</ResponseField>

<ResponseField name="[].status" type="string">
  Estado (ej. active, cancelled).
</ResponseField>

## Errores

* **401**: No autenticado.