> ## Documentation Index > Fetch the complete documentation index at: https://docs.factioapp.com/llms.txt > Use this file to discover all available pages before exploring further. # List Issuers > List Issuers for the active tenant. Returns a paginated list of issuers with optional filters. Accessible to any authenticated user within the tenant. All database operations use async/await for non-blocking I/O. Args: db: Async database session tenant_id: Active tenant ID from authentication context is_active: Optional filter by active status sri_environment: Optional filter by SRI environment search: Optional search string for razon_social, nombre_comercial, and ruc include_archived: Include archived (soft-deleted) issuers page: Page number (1-indexed) page_size: Number of items per page Returns: IssuerListResponse: Paginated list of issuers ## OpenAPI ````yaml /openapi.json get /issuers openapi: 3.1.0 info: title: Factio SRI API description: >- Plataforma headless, multi-tenant, API-first para emitir comprobantes electrónicos válidos ante el SRI de Ecuador. ## Autenticación Soporta tres métodos: - **JWT Bearer por Google OAuth**: `/auth/google/callback` - **JWT Bearer por email/password**: `/auth/login` - **API Key**: header `X-API-Key` con clave generada en `/auth/api-keys` ## Multi-tenant El aislamiento por tenant combina PostgreSQL RLS y validaciones explícitas en backend. El `tenant_id` se resuelve desde el contexto de autenticación. ## Flujo de Emisión 1. `POST /documents` — reserva secuencial y encola el documento (responde 202) 2. `GET /documents/{id}` — consulta el estado actual por polling 3. Cuando `status = AUTHORIZED`, el campo `authorization_number` contiene la clave de autorización del SRI Documentación completa en https://docs.factioapp.com version: 0.1.0 servers: - url: http://localhost:8000 description: Local - url: https://api.factioapp.com description: Producción - url: https://api.staging.factioapp.com description: Sandbox (datos de prueba, sin efecto fiscal real) security: [] paths: /issuers: get: tags: - issuers summary: List Issuers description: |- List Issuers for the active tenant. Returns a paginated list of issuers with optional filters. Accessible to any authenticated user within the tenant. All database operations use async/await for non-blocking I/O. Args: db: Async database session tenant_id: Active tenant ID from authentication context is_active: Optional filter by active status sri_environment: Optional filter by SRI environment search: Optional search string for razon_social, nombre_comercial, and ruc include_archived: Include archived (soft-deleted) issuers page: Page number (1-indexed) page_size: Number of items per page Returns: IssuerListResponse: Paginated list of issuers operationId: list_issuers_issuers_get parameters: - name: is_active in: query required: false schema: anyOf: - type: boolean - type: 'null' description: Filter by active status title: Is Active description: Filter by active status - name: sri_environment in: query required: false schema: anyOf: - $ref: '#/components/schemas/SRIEnvironment' - type: 'null' description: Filter by SRI environment title: Sri Environment description: Filter by SRI environment - name: search in: query required: false schema: anyOf: - type: string - type: 'null' description: Search in razon_social, nombre_comercial, and ruc title: Search description: Search in razon_social, nombre_comercial, and ruc - name: include_archived in: query required: false schema: type: boolean description: Include archived issuers default: false title: Include Archived description: Include archived issuers - name: page in: query required: false schema: type: integer minimum: 1 description: Page number default: 1 title: Page description: Page number - name: page_size in: query required: false schema: type: integer maximum: 100 minimum: 1 description: Items per page default: 20 title: Page Size description: Items per page - name: authorization in: header required: false schema: anyOf: - type: string - type: 'null' title: Authorization - name: x-api-key in: header required: false schema: anyOf: - type: string - type: 'null' title: X-Api-Key - name: x-tenant-id in: header required: false schema: anyOf: - type: string - type: 'null' title: X-Tenant-Id - name: factio_access_token in: cookie required: false schema: anyOf: - type: string - type: 'null' title: Factio Access Token responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/IssuerListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: SRIEnvironment: type: string enum: - TEST - PRODUCTION title: SRIEnvironment description: SRI environment types. IssuerListResponse: properties: items: items: $ref: '#/components/schemas/IssuerResponse' type: array title: Items total: type: integer title: Total page: type: integer title: Page page_size: type: integer title: Page Size type: object required: - items - total - page - page_size title: IssuerListResponse description: Schema for paginated list of Issuers. example: items: [] page: 1 page_size: 20 total: 0 HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError IssuerResponse: properties: id: type: string format: uuid title: Id tenant_id: type: string format: uuid title: Tenant Id ruc: type: string title: Ruc razon_social: type: string title: Razon Social nombre_comercial: anyOf: - type: string - type: 'null' title: Nombre Comercial legal_representative: anyOf: - type: string - type: 'null' title: Legal Representative direccion_matriz: type: string title: Direccion Matriz tipo_contribuyente: type: string title: Tipo Contribuyente sri_environment: $ref: '#/components/schemas/SRIEnvironment' is_active: type: boolean title: Is Active created_at: type: string format: date-time title: Created At updated_at: type: string format: date-time title: Updated At type: object required: - id - tenant_id - ruc - razon_social - nombre_comercial - legal_representative - direccion_matriz - tipo_contribuyente - sri_environment - is_active - created_at - updated_at title: IssuerResponse description: Schema for Issuer response. example: created_at: '2024-01-01T00:00:00Z' direccion_matriz: Av. Principal 123 y Secundaria, Quito, Ecuador id: 550e8400-e29b-41d4-a716-446655440000 is_active: true legal_representative: Jane Doe nombre_comercial: Ejemplo Corp razon_social: EMPRESA EJEMPLO S.A. ruc: '1234567890001' sri_environment: TEST tenant_id: 660e8400-e29b-41d4-a716-446655440000 tipo_contribuyente: General updated_at: '2024-01-01T00:00:00Z' ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ````