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

> Lista las empresas (emisores) de la cuenta. Con include_certificados=true incluye el detalle de CSD.



## OpenAPI

````yaml /openapi.json get /empresas
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:
  /empresas:
    get:
      tags:
        - Empresas
      summary: Listar empresas
      description: >-
        Lista las empresas (emisores) de la cuenta. Con
        include_certificados=true incluye el detalle de CSD.
      operationId: list
      parameters:
        - name: include_certificados
          in: query
          required: false
          schema:
            type: boolean
            default: false
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/EmpresaListResponse'
components:
  schemas:
    EmpresaListResponse:
      type: object
      properties:
        empresas:
          type: array
          items:
            $ref: '#/components/schemas/EmpresaItemResponse'
    EmpresaItemResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
        rfc:
          type: string
        certificados:
          type: array
          items:
            $ref: '#/components/schemas/CertificadoItemResponse'
        nombre_empresa:
          type: string
        nombre_fiscal:
          type: string
        codigo_postal:
          type: string
    CertificadoItemResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
        estado:
          type: string
        numero_certificado:
          type: string
        fecha_creacion:
          type: string
        fecha_fin:
          type: string
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      description: API key emitida por Ipsofactura, enviada en el header x-api.
      name: x-api
      in: header

````