# Listar depósitos

`GET https://api.fiscalisto.com/v1/bank_transactions`

Los más recientes primero; los abiertos con su suggested_match.

## Parámetros

| Nombre | Dónde | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `limit` | consulta |  | Cuántos por página, de 1 a 100. Por omisión 10. |
| `starting_after` | consulta |  | El id del último de la página anterior, para la siguiente. |
| `issuer` | consulta |  | El emisor (iss_…). Puede omitirse si la llave o la cuenta tienen uno solo. |
| `status` | consulta |  | open (sin conciliar), matched o classified. |

## Con el SDK de TypeScript

```ts
import { Fiscalisto } from "fiscalisto";

// La llave viene de FISCALISTO_API_KEY.
const fiscalisto = new Fiscalisto();

for await (const item of fiscalisto.bankTransactions.list()) {
  console.log(item.id);
}
```

## Con el SDK de Python

```python
from fiscalisto import Fiscalisto

# La llave viene de FISCALISTO_API_KEY.
fiscalisto = Fiscalisto()

for item in fiscalisto.bank_transactions.list():
    print(item["id"])
```

## Con el SDK de PHP

```php
<?php

use Fiscalisto\Fiscalisto;

// La llave viene de FISCALISTO_API_KEY.
$fiscalisto = new Fiscalisto();

foreach ($fiscalisto->bankTransactions->list() as $item) {
    echo $item['id'], "\n";
}
```

## Con el SDK de .NET

```csharp
using Fiscalisto;

// La llave viene de FISCALISTO_API_KEY.
var fiscalisto = new FiscalistoClient();

await foreach (var item in fiscalisto.BankTransactions.ListAutoPagingAsync())
    Console.WriteLine(item.Id);
```

## Con el SDK de Go

```go
package main

import (
	"context"
	"fmt"
	"log"

	fiscalisto "fiscalisto.com/go"
)

func main() {
	// La llave viene de FISCALISTO_API_KEY.
	client, err := fiscalisto.NewClient("")
	if err != nil {
		log.Fatal(err)
	}
	ctx := context.Background()

	for item, err := range client.BankTransactions.ListAutoPaging(ctx, nil) {
		if err != nil {
			log.Fatal(err)
		}
		fmt.Println(item.ID)
	}
}
```

## Con el SDK de Java

```java
import com.fiscalisto.FiscalistoClient;

// La llave viene de FISCALISTO_API_KEY.
var fiscalisto = new FiscalistoClient();

for (var item : fiscalisto.bankTransactions().listAutoPaging()) {
    System.out.println(item.getId());
}
```

## Respuesta 200

Correcto.

Un objeto `BankTransactionList`:

| Campo | Tipo | Siempre viene | Descripción |
| --- | --- | --- | --- |
| `object` | `"list"` | sí | Qué tipo de objeto es («invoice», «customer»…). |
| `data` | arreglo de objeto | sí | Los objetos de esta página. |
| `data[].id` | string | sí | Identificador del objeto, con su prefijo (iss_, inv_, ret_, cus_, prd_, emp_, bat_, brn_, whs_, stm_, adj_, evt_, whe_). |
| `data[].livemode` | boolean | sí | true en producción (llaves fk_live_), false en pruebas (fk_test_). Lo de pruebas no vale ante el SAT. |
| `data[].object` | `"bank_transaction"` | sí | Qué tipo de objeto es («invoice», «customer»…). |
| `data[].issuer` | string | sí | El emisor. |
| `data[].date` | string | sí | El día del depósito (AAAA-MM-DD). |
| `data[].amount` | number | sí | Lo depositado, en pesos. |
| `data[].description` | string | sí | El concepto del banco. |
| `data[].reference` | string o null | sí | La referencia o clave de rastreo, o null. |
| `data[].account` | string o null | sí | Los últimos 4 dígitos de la cuenta, o null. |
| `data[].payer_tax_id` | string o null | sí | El RFC de quien depositó, si se sabe. |
| `data[].status` | `open`, `matched`, `classified` | sí | open (sin conciliar), matched (pagó facturas) o classified (no es de una factura). |
| `data[].classification` | `venta`, `prestamo`, `traspaso`, `devolucion` o null | sí | classified: venta (aún sin facturar), prestamo, traspaso o devolucion; si no, null. |
| `data[].note` | string o null | sí | Una nota al clasificarlo, o null. |
| `data[].invoices` | arreglo de string | sí | Las facturas (inv_…) que pagó, si está conciliado. |
| `data[].payment` | string o null | sí | El complemento de pago (inv_…) timbrado con él, o null. |
| `data[].suggested_match` | objeto o null | sí | Si está abierto, las facturas que parece pagar (por monto, RFC, folio en el concepto y fecha): invoices, lo que toca a cada una (amounts), method, confidence (high o medium) y por qué (reasons). null si ninguna encaja. |
| `data[].suggested_match.invoices` | arreglo de string | sí | Las facturas, como el cuerpo de POST /v1/invoices, con reference opcional. |
| `data[].suggested_match.amounts` | objeto | sí | Lo que el depósito pagaría de cada factura (por inv_…). |
| `data[].suggested_match.method` | `PPD`, `PUE` | sí | egreso (la factura completa y después una nota de crédito por el anticipo, opción A) o remanente (la factura solo por lo que falta, opción B). |
| `data[].suggested_match.confidence` | `high`, `medium` | sí | high (el monto y además el RFC, el nombre o el folio coinciden) o medium (revíselo antes). |
| `data[].suggested_match.reasons` | arreglo de string | sí | Por qué se sugiere, en palabras. |
| `data[].created_at` | string (date-time) o null | sí | Cuándo se mandó. |
| `has_more` | boolean | sí | true si hay más: pida la siguiente con starting_after igual al id del último. |
| `url` | string | sí | La ruta de esta lista. |

```json
{
  "object": "list",
  "data": [
    {
      "id": "btx_OufpKqnrvx9p9Rt4sLm2XyT5uBcW8sKdLx",
      "object": "bank_transaction",
      "livemode": false,
      "issuer": "iss_OufpKqnrvx9p",
      "date": "2026-10-24",
      "amount": 5800,
      "description": "SPEI RECIBIDO INMOBILIARIA CVA · ICV060329BY0",
      "reference": "F-1024",
      "account": "4821",
      "payer_tax_id": "ICV060329BY0",
      "status": "open",
      "classification": null,
      "note": null,
      "invoices": [],
      "payment": null,
      "suggested_match": {
        "invoices": [
          "inv_OufpKqnrvx9p6hW1yQbT3mZr8sKdLx0VeN"
        ],
        "amounts": {
          "inv_OufpKqnrvx9p6hW1yQbT3mZr8sKdLx0VeN": 5800
        },
        "method": "PUE",
        "confidence": "high",
        "reasons": [
          "Mismo monto",
          "RFC del cliente en el concepto"
        ]
      },
      "created_at": "2026-10-25T09:00:00-06:00"
    }
  ],
  "has_more": false,
  "url": "/v1/bank_transactions"
}
```

## Errores

Puede responder 400, 401, 403, 404, 429, 500 con el cuerpo de error de siempre; cada código está en https://fiscalisto.com/docs/api/errores.md.