> ## Documentation Index > Fetch the complete documentation index at: https://docs.facture.ar/llms.txt > Use this file to discover all available pages before exploring further. # Listar facturas > Lista las facturas del entorno de la API key, de la más nueva a la más vieja, con filtros y paginación. ## OpenAPI ````yaml /openapi.json get /invoices openapi: 3.1.0 info: title: Facturear API description: >- API para emitir facturas electrónicas de ARCA (Argentina) desde tu sistema: facturas, notas de crédito y débito, lotes, PDF y XML, envío por email, borradores desde documentos, webhooks y reportes. Autenticación con API Key en el header x-api-key: la key de testing opera en homologación y la de producción emite comprobantes reales. version: 1.0.0 contact: name: Facturear Support email: support@facture.ar url: https://facture.ar license: name: MIT url: https://opensource.org/licenses/MIT servers: - url: https://www.facture.ar/api description: Servidor de producción security: - apiKey: [] tags: - name: CUITs description: CUITs emisores, sus defaults, puntos de venta y diseño - name: Facturas description: Emitir, listar y consultar facturas, su PDF y XML, y enviarlas por email - name: Lotes description: 'El resultado de cada emisión: toda factura se procesa en un lote' - name: Borradores description: >- Facturas propuestas desde documentos, planillas o datos, para revisar y emitir - name: Plantillas description: Cómo se lee y se factura cada tipo de documento, y facturas recurrentes - name: Importar desde ARCA description: Traer a Facturear los comprobantes que ARCA ya autorizó - name: Webhooks description: Notificaciones a tu sistema cuando pasa algo con tus facturas - name: Reportes description: Libro IVA Ventas - name: Utilidades description: Parámetros de ARCA paths: /invoices: get: tags: - Facturas summary: Listar facturas description: >- Lista las facturas del entorno de la API key, de la más nueva a la más vieja, con filtros y paginación. parameters: - name: cuit in: query description: CUIT emisor (o parte de él) required: false schema: type: string - name: cuitId in: query description: ID del CUIT emisor en Facturear (filtro exacto). Alternativa a cuit required: false schema: type: string - name: tipo in: query description: Código de ARCA del tipo de comprobante required: false schema: type: integer - name: comprobante in: query description: Número de comprobante required: false schema: type: string - name: receptor in: query description: >- Documento del receptor (CUIT, CUIL o DNI, con o sin guiones: busca por DocNro exacto) o parte de su nombre (clientName, sin distinguir mayúsculas) required: false schema: type: string - name: status in: query description: Estado de la factura required: false schema: type: string enum: - success - error - processing - name: search in: query description: >- Busca en CUIT emisor, número de comprobante, código de tipo de comprobante y descripción required: false schema: type: string - name: page in: query description: Número de página required: false schema: type: integer minimum: 1 default: 1 - name: limit in: query description: Elementos por página required: false schema: type: integer minimum: 1 maximum: 100 default: 10 responses: '200': description: Facturas obtenidas exitosamente content: application/json: schema: type: object properties: invoices: type: array items: $ref: '#/components/schemas/Invoice' pagination: $ref: '#/components/schemas/Meta' components: schemas: Invoice: type: object required: - id - userId - cuitId - environment - amount - voucherNumber - feCAEReq - status - createdAt - updatedAt properties: id: type: string description: ID de la factura userId: type: string description: ID del usuario cuitId: type: string description: ID del CUIT emisor environment: type: string enum: - production - homologation description: Entorno en el que se emitió amount: type: number example: 1210 description: Importe total voucherNumber: type: integer example: 145 description: Número de comprobante ptoVta: type: - integer - 'null' description: Punto de venta example: 1 invoiceType: type: - integer - 'null' description: Tipo de comprobante (código de ARCA) example: 11 feCAEReq: type: object description: >- Solicitud enviada a ARCA (FeCAEReq con FeCabReq y FeDetReq), más items, tributos y clientName feCabResp: type: - object - 'null' description: >- Respuesta de ARCA tal cual (FeCabResp y FeDetResp; el CAE y su vencimiento están en FeDetResp.FECAEDetResponse) status: type: string enum: - processing - success - error description: Estado de la factura errorMessage: type: - string - 'null' description: Motivo del error, si status es error description: type: - string - 'null' description: Descripción de la factura issuedAt: type: string format: date-time description: >- 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: type: string enum: - facturear - arca description: >- facturear: emitida desde Facturear. arca: copiada de un comprobante que ARCA ya había autorizado (Importar desde ARCA) voidedBy: type: - string - 'null' description: >- ID de la nota de crédito que anuló esta factura (POST /invoices/{invoiceId}/credit-note), o null. Solo viene en GET /invoices createdAt: type: string format: date-time description: Fecha de creación updatedAt: type: string format: date-time description: Fecha de última actualización cuit: type: object description: CUIT emisor. persona solo viene en GET /invoices/{invoiceId} properties: number: type: string description: Número de CUIT example: 20-12345678-9 persona: type: - object - 'null' description: Datos del padrón de ARCA del emisor Meta: type: object required: - page - limit - totalCount - totalPages - hasNextPage - hasPrevPage properties: page: type: integer example: 1 description: Página actual limit: type: integer example: 10 description: Elementos por página totalCount: type: integer example: 42 description: Total de elementos totalPages: type: integer example: 5 description: Total de páginas hasNextPage: type: boolean description: Hay una página siguiente hasPrevPage: type: boolean description: Hay una página anterior securitySchemes: apiKey: type: apiKey in: header name: x-api-key description: >- API Key para autenticación. Formato: test_sk_xxx para testing, prod_sk_xxx para producción. ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.