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

# Listar CFDIs

> Devuelve los CFDIs de la cuenta, paginados. Filtra opcionalmente por tipo de comprobante.



## OpenAPI

````yaml /openapi.json get /cfdi
openapi: 3.1.0
info:
  title: Ipsofactura API
  description: API de timbrado CFDI 4.0 de Palenca.
  version: v1
servers:
  - url: https://api.ipsofactura.com
    description: Producción
  - url: https://sandbox.api.ipsofactura.com
    description: Sandbox (pruebas, sin validez fiscal)
security:
  - apiKeyAuth: []
tags:
  - name: CFDI
    description: Timbrado, complemento de pago, cancelación y descarga de CFDIs.
  - name: Empresas
    description: Alta y consulta de empresas emisoras.
  - name: Certificados
    description: Administración del Certificado de Sello Digital (CSD).
paths:
  /cfdi:
    get:
      tags:
        - CFDI
      summary: Listar CFDIs
      description: >-
        Devuelve los CFDIs de la cuenta, paginados. Filtra opcionalmente por
        tipo de comprobante.
      operationId: list_1
      parameters:
        - name: page
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: 1
        - name: per_page
          in: query
          required: false
          schema:
            type: integer
            format: int32
            default: 50
        - name: tipo_comprobante
          in: query
          required: false
          schema:
            type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/FacturaListResponse'
components:
  schemas:
    FacturaListResponse:
      type: object
      properties:
        facturas:
          type: array
          items:
            $ref: '#/components/schemas/FacturaItemResponse'
        pagination:
          $ref: '#/components/schemas/PaginationResponse'
    FacturaItemResponse:
      type: object
      properties:
        uuid:
          type: string
        serie:
          type: string
        folio:
          type: string
        fecha:
          type: string
        total:
          type: number
        moneda:
          type: string
        estatus:
          type: string
        subtotal:
          type: number
        tipo_comprobante:
          type: string
        emisor_rfc:
          type: string
        emisor_nombre:
          type: string
        receptor_rfc:
          type: string
        receptor_nombre:
          type: string
        tipo_cambio:
          type: number
        fecha_timbrado:
          type: string
        metodo_pago:
          type: string
        forma_pago:
          type: string
        uso_cfdi:
          type: string
        xml_url:
          type: string
    PaginationResponse:
      type: object
      properties:
        page:
          type: integer
          format: int32
        per_page:
          type: integer
          format: int32
        total_items:
          type: integer
          format: int64
        total_pages:
          type: integer
          format: int32
        has_next:
          type: boolean
        has_prev:
          type: boolean
        next_page:
          type: integer
          format: int32
        prev_page:
          type: integer
          format: int32
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      description: API key emitida por Ipsofactura, enviada en el header x-api.
      name: x-api
      in: header

````