> ## 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.

# Buscar facturas

> Busca facturas con filtros específicos como fecha, CUIT, estado, etc.



## OpenAPI

````yaml /openapi.json get /invoices/search
openapi: 3.1.0
info:
  title: Facturear API
  description: >-
    API completa para facturación electrónica en Argentina. Integra con AFIP y
    genera facturas electrónicas válidas de forma rápida y segura.
  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://facture.ar/api
    description: Servidor de producción
security:
  - apiKey: []
paths:
  /invoices/search:
    get:
      tags:
        - Facturas
      summary: Buscar facturas
      description: Busca facturas con filtros específicos como fecha, CUIT, estado, etc.
      parameters:
        - name: cuitId
          in: query
          description: ID del CUIT
          required: false
          schema:
            type: string
            format: uuid
        - name: status
          in: query
          description: Estado de la factura
          required: false
          schema:
            type: string
            enum:
              - pending
              - processing
              - completed
              - failed
        - name: dateFrom
          in: query
          description: Fecha desde (ISO 8601)
          required: false
          schema:
            type: string
            format: date
        - name: dateTo
          in: query
          description: Fecha hasta (ISO 8601)
          required: false
          schema:
            type: string
            format: date
        - 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: 20
      responses:
        '200':
          description: Búsqueda realizada exitosamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Invoice'
                  meta:
                    $ref: '#/components/schemas/Meta'
components:
  schemas:
    Invoice:
      type: object
      required:
        - id
        - cuitId
        - amount
        - status
        - createdAt
      properties:
        id:
          type: string
          format: uuid
          description: ID único de la factura
        cuitId:
          type: string
          format: uuid
          description: ID del CUIT emisor
        amount:
          type: number
          format: float
          description: Monto de la factura
        description:
          type: string
          description: Descripción de la factura
        status:
          type: string
          enum:
            - pending
            - processing
            - completed
            - failed
          description: Estado de la factura
        invoiceNumber:
          type: string
          description: Número de factura generado por AFIP
        cae:
          type: string
          description: Código de Autorización Electrónica
        caeExpirationDate:
          type: string
          format: date
          description: Fecha de vencimiento del CAE
        qrCode:
          type: string
          description: Código QR de la factura
        pdfUrl:
          type: string
          format: uri
          description: URL del PDF de la factura
        createdAt:
          type: string
          format: date-time
          description: Fecha de creación
        updatedAt:
          type: string
          format: date-time
          description: Fecha de última actualización
    Meta:
      type: object
      properties:
        page:
          type: integer
          description: Página actual
        limit:
          type: integer
          description: Elementos por página
        total:
          type: integer
          description: Total de elementos
        totalPages:
          type: integer
          description: Total de páginas
  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.

````