> ## Documentation Index > Fetch the complete documentation index at: https://docs.fegora.com/llms.txt > Use this file to discover all available pages before exploring further. # Listar cuentas ## OpenAPI ````yaml /api-reference/openapi.json get /cuenta openapi: 3.1.0 info: title: Fegora API version: '1.0' description: >- API de Fegora para la emisión y consulta de Documentos Tributarios Electrónicos (DTE) en Guatemala, El Salvador y República Dominicana. El API es uno solo para los tres países: el país de operación lo determina la configuración de la cuenta emisora (no la URL ni ningún parámetro de la solicitud). Los campos que varían por país — tipos de documento, catálogos de impuestos, identificadores fiscales del receptor, datos adicionales — se documentan en la descripción de cada campo. Autenticación: OAuth2 (`POST /token`, grant types `password` y `refresh_token`) → JWT Bearer con vigencia de 24 horas. servers: - url: https://api.fegora.com security: - bearerAuth: [] tags: - name: Autenticación description: Obtención y renovación de tokens de acceso. - name: DTE description: Emisión, consulta, anulación y distribución de documentos emitidos. - name: DTE Recibidos description: Documentos donde la cuenta es el receptor (facturas de proveedores). - name: Lotes description: Carga masiva de DTEs mediante archivos Excel. - name: Cuentas description: Administración de cuentas emisoras/receptoras. - name: Catálogos description: >- Catálogos de referencia: productos, plantillas de PDF, localidades y contribuyentes. - name: Otros description: Endpoints de soporte, como el perfil del usuario autenticado. paths: /cuenta: get: tags: - Cuentas summary: Listar cuentas operationId: getCuenta parameters: - name: idCanal in: query schema: type: integer - name: emiteFacturas in: query schema: type: boolean - name: estaEnAmbienteDePruebas in: query schema: type: boolean - name: searchText in: query schema: type: string - name: pageNumber in: query schema: type: integer default: 1 description: Número de página (base 1). - name: pageSize in: query schema: type: integer default: 10 description: Tamaño de página. responses: '200': description: Listado paginado de cuentas. content: application/json: schema: $ref: '#/components/schemas/CuentaListado' examples: ok: value: data: - id: '12345678' idCanal: 1 canal: id: 1 nombre: API nombreCorto: api idCertificador: '12345678' certificador: id: '12345678' tieneCertificado: true direccionCorreoElectronico: ventas@ejemplo.com.gt direccionWeb: ejemplo.com.gt telefonos: 2222-1155, 5555-6654 logoUri: https://cdn.fegora.com/imagenes/12345678_logo.png slogan: De todo para todos emiteFacturas: true recibeFacturas: false estaEnAmbienteDePruebas: false monedaPorDefecto: GTQ tipoDocumentoPorDefecto: factura tipoProductoPorDefecto: bien unidadMedidaPorDefecto: uni informacionFiscal: id: '12345678' nombre: DISTRIBUIDORA DETODO, SOCIEDAD ANONIMA nombreComercial: DETODO afiliacionIva: GENERAL afiliacionIsr: >- ISR_OPCIONAL_SIMPLIFICADO_SOBRE_INGRESOS_ACTIVIDADES_LUCRATIVAS codigoEstablecimiento: '1' esExentoIva: false esRetenedorIva: true direccion: direccion: Ruta 8 3-65 Zona 4 Guatemala municipio: Guatemala departamento: Guatemala codigoPostal: '01004' pais: GT establecimientos: [] datosAdicionales: [] plantillasPdf: [] plantillasMensajeCorreoElectronico: [] usuarios: [] meta: totalItems: 1 totalPages: 1 pageNumber: 1 pageSize: 20 '401': description: No autenticado. El token es inválido, expiró o no fue enviado. content: application/json: schema: $ref: '#/components/schemas/Error' examples: noAutenticado: summary: Token ausente, inválido o expirado value: codigo: FEG_UNAUTHORIZED mensaje: No está autorizado para acceder a este recurso masInformacion: https://developer.fegora.com severidad: 2 components: schemas: CuentaListado: type: object properties: data: type: array items: $ref: '#/components/schemas/Cuenta' meta: $ref: '#/components/schemas/MetaPagina' links: $ref: '#/components/schemas/LinksPagina' Error: type: object description: Formato estándar de error de Fegora. Se usa en toda respuesta 4xx. properties: codigo: type: string description: >- Código de error interno de Fegora (p. ej. `FEG_VALIDATION_ERROR`, `FEG_DTE_CREA_001`). Ver la tabla de códigos de error en la guía de introducción. examples: - FEG_VALIDATION_ERROR mensaje: type: string description: Mensaje descriptivo del error, en español. masInformacion: type: string format: uri description: Enlace a documentación adicional sobre el error. examples: - https://developer.fegora.com severidad: type: integer enum: - 0 - 1 - 2 - 3 description: 0 = Sugerencia, 1 = Advertencia, 2 = Error, 3 = Fatal. required: - codigo - mensaje Cuenta: type: object description: >- Cuenta emisora/receptora. El país de operación de la cuenta (Guatemala, El Salvador o República Dominicana) se define en `informacionFiscal.direccion.pais` y en la configuración del certificador — no hay un campo único de "país de la cuenta". properties: id: type: string description: NIT (o RNC en República Dominicana) de la cuenta. idCanal: type: integer canal: $ref: '#/components/schemas/CuentaCanal' idCertificador: type: string certificador: $ref: '#/components/schemas/CuentaCertificador' tieneCertificado: type: boolean description: >- Si la cuenta tiene un certificado de firma (.pfx) configurado. El certificado y su clave nunca se devuelven. direccionCorreoElectronico: type: string direccionWeb: type: string telefonos: type: string logoUri: type: string slogan: type: string emiteFacturas: type: boolean recibeFacturas: type: boolean estaEnAmbienteDePruebas: type: boolean monedaPorDefecto: type: string tipoDocumentoPorDefecto: type: string tipoProductoPorDefecto: type: string unidadMedidaPorDefecto: type: string informacionFiscal: $ref: '#/components/schemas/CuentaInformacionFiscal' establecimientos: type: array items: $ref: '#/components/schemas/CuentaEstablecimiento' datosAdicionales: type: array items: $ref: '#/components/schemas/CuentaDatoAdicional' plantillasPdf: type: array items: $ref: '#/components/schemas/CuentaPlantillaPdf' plantillasMensajeCorreoElectronico: type: array items: $ref: '#/components/schemas/CuentaPlantillaMensajeCorreoElectronico' usuarios: type: array items: $ref: '#/components/schemas/CuentaUsuario' required: - id MetaPagina: type: object properties: totalItems: type: integer format: int64 totalPages: type: integer format: int64 pageNumber: type: integer pageSize: type: integer LinksPagina: type: object properties: self: type: string prev: type: - string - 'null' next: type: - string - 'null' first: type: string last: type: string CuentaCanal: type: object properties: id: type: integer nombre: type: string nombreCorto: type: string logoUri: type: string CuentaCertificador: type: object properties: id: type: string CuentaInformacionFiscal: type: object properties: id: type: string nombre: type: string nombreComercial: type: string afiliacionIva: type: string afiliacionIsr: type: string afiliacionIsrResolucionSat: type: string codigoEstablecimiento: type: string esExentoIva: type: boolean esRetenedorIva: type: boolean motivoExencionIva: type: string direccionCorreoElectronico: type: string direccion: $ref: '#/components/schemas/CuentaDireccion' CuentaEstablecimiento: type: object properties: id: type: string nombre: type: string direccion: type: string codigoPostal: type: string municipio: type: string departamento: type: string pais: type: string logoUri: type: string tipo: type: string CuentaDatoAdicional: type: object properties: nombre: type: string valor: type: string required: - nombre CuentaPlantillaPdf: type: object properties: id: type: string format: uuid nombre: type: string archivoUri: type: string tiposDte: type: string condicionAdicional: type: string prioridad: type: integer CuentaPlantillaMensajeCorreoElectronico: type: object properties: id: type: string format: uuid idPlantillaProveedor: type: string textoAsunto: type: string textoEncabezado: type: string textoPie: type: string prioridad: type: integer CuentaUsuario: type: object properties: nombres: type: string apellidos: type: string username: type: string roles: type: array items: $ref: '#/components/schemas/CuentaRol' CuentaDireccion: type: object properties: direccion: type: string codigoPostal: type: string municipio: type: string departamento: type: string idMunicipio: type: string idDepartamento: type: string pais: type: string CuentaRol: type: object properties: id: type: string nombre: type: string securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````