---
title: "Listar facturas"
method: GET
path: "/invoices"
tags: ["Facturas"]
---

# Listar facturas

`GET /invoices`

## Request

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

Lista las facturas del entorno de la API key, de la más nueva a la más vieja, con filtros y paginación.

## Query parameters

- `cuit` string
- `cuitId` string
- `tipo` integer
- `comprobante` string
- `receptor` string
- `status` 'success' | 'error' | 'processing'
- `search` string
- `page` integer
- `limit` integer

## Response `200`

Facturas obtenidas exitosamente

- object
  - `invoices` Invoice[]
    - `id` string, required: ID de la factura
    - `userId` string, required: ID del usuario
    - `cuitId` string, required: ID del CUIT emisor
    - `environment` 'production' | 'homologation', required: Entorno en el que se emitió
    - `amount` number, required: Importe total
    - `voucherNumber` integer, required: Número de comprobante
    - `ptoVta` integer, nullable: Punto de venta
    - `invoiceType` integer, nullable: Tipo de comprobante (código de ARCA)
    - `feCAEReq` object, required: Solicitud enviada a ARCA (FeCAEReq con FeCabReq y FeDetReq), más items, tributos y clientName
    - `feCabResp` object, nullable: Respuesta de ARCA tal cual (FeCabResp y FeDetResp; el CAE y su vencimiento están en FeDetResp.FECAEDetResponse)
    - `status` 'processing' | 'success' | 'error', required: Estado de la factura
    - `errorMessage` string, nullable: Motivo del error, si status es error
    - `description` string, nullable: Descripción de la factura
    - `issuedAt` string, date-time: Cuándo ARCA autorizó el comprobante. En las facturas emitidas desde Facturear es la fecha de creación; en las importadas desde ARCA, la fecha del comprobante. Los reportes agrupan por este campo
    - `origin` 'facturear' | 'arca': facturear: emitida desde Facturear. arca: copiada de un comprobante que ARCA ya había autorizado (Importar desde ARCA)
    - `voidedBy` string, nullable: ID de la nota de crédito que anuló esta factura (POST /invoices/{invoiceId}/credit-note), o null. Solo viene en GET /invoices
    - `createdAt` string, date-time, required: Fecha de creación
    - `updatedAt` string, date-time, required: Fecha de última actualización
    - `cuit` object: CUIT emisor. persona solo viene en GET /invoices/{invoiceId}
      - `number` string: Número de CUIT
      - `persona` object, nullable: Datos del padrón de ARCA del emisor
  - `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)