---
title: "Listar lotes de facturas"
method: GET
path: "/invoices/batches"
tags: ["Lotes"]
---

# Listar lotes de facturas

`GET /invoices/batches`

## Request

- Base URL: `https://www.facture.ar/api`
- URL: `https://www.facture.ar/api/invoices/batches`
- Auth: API key in header `x-api-key`

Obtiene la lista de lotes de facturas con paginación.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Lista de lotes obtenida exitosamente

- object
  - `batches` Batch[]
    - `id` string, required: ID del lote
    - `userId` string, required: ID del usuario
    - `environment` 'production' | 'homologation', required: Entorno
    - `status` 'pending' | 'processing' | 'completed' | 'completed_with_errors' | 'error', required: Estado del lote
    - `totalItems` integer, required: Total de items en el lote
    - `processedItems` integer, required: Items procesados (con éxito o con error)
    - `successfulItems` integer, required: Items procesados con éxito
    - `failedItems` integer, required: Items que fallaron
    - `createdAt` string, date-time, required: Fecha de creación
    - `updatedAt` string, date-time, required: Fecha de última actualización
    - `jobs` BatchItem[]: Items del lote
      - `id` string, required: ID del item
      - `status` 'pending' | 'processing' | 'completed' | 'error', required: Estado del item
      - `order` integer, required: Posición del item en su cola
      - `createdAt` string, date-time, required: Fecha de creación
      - `updatedAt` string, date-time, required: Fecha de última actualización
      - `requestBody` object, required: Factura encolada: los campos de InvoiceRequest ya completados con los valores por defecto del CUIT
      - `responseBody` object, nullable: Resultado del procesamiento (la factura emitida o el detalle del error)
  - `pagination` Meta
    - `page` integer, required: Página actual
    - `limit` integer, required: Elementos por página
    - `totalCount` integer, required: Total de elementos
    - `totalPages` integer, required: Total de páginas
    - `hasNextPage` boolean, required: Hay una página siguiente
    - `hasPrevPage` boolean, required: Hay una página anterior

---

[API](https://skmtc.dev/facture/apis/facturear-api.md) · [All operations](https://skmtc.dev/facture/apis/facturear-api/llms.txt) · [OpenAPI document](https://skmtc.dev/facture/apis/facturear-api/revisions/b572c5908978?raw)