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

# Obtener transacciones masivas

> Devuelve transacciones recientes de hasta 100 usuarios conectados en una sola llamada, de más nuevas a más antiguas, con un valor predeterminado de los últimos 90 días.

Devuelve transacciones recientes de hasta **100 usuarios conectados** en una sola llamada — como máximo **20 por objetivo**, de más nuevas a más antiguas, con un valor predeterminado de los **últimos 90 días**.

## Requisitos

* `Authorization: Basic <API_KEY>` (la clave API de tu aplicación)
* La **capacidad de API masiva** en tu aplicación
* Los alcances `LIST_PAYMENT` y `LIST_PURCHASES` en la concesión de cada usuario objetivo

Los errores se informan por objetivo y nunca fallan toda la solicitud. Consulta [Descripción general de la API masiva](/bulk-api) para el modelo de direccionamiento y los códigos de error.

## Consulta

```graphql theme={null}
query GetBulkTransactions(
  $targetSpec: BulkTargetSpecInput!
  $createdGte: DateTime
  $createdLte: DateTime
  $includeMetadata: Boolean
) {
  getBulkTransactions(
    targetSpec: $targetSpec
    createdGte: $createdGte
    createdLte: $createdLte
    includeMetadata: $includeMetadata
  ) {
    targetCount
    successCount
    failureCount
    results {
      externalReferenceId
      accountId
      success
      error { code message }
      totalCount
      hasNextPage
      transactions {
        recordId
        transactionType
        amount
        status
        createdAt
        memo
        transactionCategory
      }
    }
  }
}
```

### Variables

```json theme={null}
{
  "targetSpec": { "mode": "SELECTED", "targets": ["your-user-001"] },
  "createdGte": null,
  "createdLte": null,
  "includeMetadata": false
}
```

## Respuesta

```json theme={null}
{
  "data": {
    "getBulkTransactions": {
      "targetCount": 1,
      "successCount": 1,
      "failureCount": 0,
      "results": [
        {
          "externalReferenceId": "your-user-001",
          "accountId": "8f3c…",
          "success": true,
          "error": null,
          "totalCount": 42,
          "hasNextPage": true,
          "transactions": [
            {
              "recordId": "rec-1",
              "transactionType": "GIFT_CARD_PURCHASE",
              "amount": 25.0,
              "status": "SETTLED",
              "createdAt": "2026-07-01T00:00:00.000Z",
              "memo": null,
              "transactionCategory": null
            }
          ]
        }
      ]
    }
  }
}
```

## Argumentos

| Argumento         | Tipo                   | Descripción                                                                                                              |
| ----------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `targetSpec`      | `BulkTargetSpecInput!` | Selección de objetivos. Máximo 100 objetivos. Consulta la [Descripción general](/bulk-api).                              |
| `createdGte`      | `DateTime`             | Incluir solo transacciones creadas en o después de este momento. De forma predeterminada, 90 días antes de `createdLte`. |
| `createdLte`      | `DateTime`             | Incluir solo transacciones creadas en o antes de este momento. De forma predeterminada, ahora.                           |
| `includeMetadata` | `Boolean`              | También devuelve `memo` y `transactionCategory`. Más lento; el valor predeterminado es `false`.                          |

## Campos de la respuesta

| Campo                                           | Descripción                                                                                                                                                                         |
| ----------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `results[].transactions`                        | Hasta 20 transacciones más recientes en la ventana, de más nuevas a más antiguas. Restringidas a cuentas de gasto permitidas cuando la concesión está limitada por cuenta de gasto. |
| `results[].totalCount`                          | Total de transacciones que coinciden con la ventana para este objetivo.                                                                                                             |
| `results[].hasNextPage`                         | `true` cuando el objetivo tiene más de las 20 devueltas.                                                                                                                            |
| `targetCount` / `successCount` / `failureCount` | Resumen a nivel de solicitud.                                                                                                                                                       |

## Límites y cómo obtener el historial completo

* **20 transacciones por objetivo** y una **ventana máxima de 90 días** por solicitud. Una ventana mayor a 90 días se rechaza — reduce el rango o utiliza la exportación.
* Cuando `hasNextPage` es `true` o `totalCount` excede lo devuelto, hay más datos. Esta consulta acotada nunca trunca en silencio; para el historial completo usa la **exportación de transacciones asíncrona** (próximamente).
* `includeMetadata: true` agrega `memo` y `transactionCategory` por transacción con algún costo de latencia. Los enlaces de adjuntos no se incluyen en la ruta masiva — utiliza la exportación para metadatos completos.