> ## 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 Certificates > List certificates for an Issuer. Returns a list of certificates with metadata (no password or file). Indicates status: active, expiring, expired, revoked. All database operations use async/await for non-blocking I/O. Args: issuer_id: UUID of the parent issuer db: Async database session tenant_id: Active tenant ID from authentication context user_id: Current user ID for auditing Returns: CertificateListResponse: List of certificates Raises: HTTPException 404: If issuer not found or doesn't belong to tenant ## OpenAPI ````yaml /openapi.json get /issuers/{issuer_id}/certificates 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/{issuer_id}/certificates: get: tags: - certificates summary: List Certificates description: |- List certificates for an Issuer. Returns a list of certificates with metadata (no password or file). Indicates status: active, expiring, expired, revoked. All database operations use async/await for non-blocking I/O. Args: issuer_id: UUID of the parent issuer db: Async database session tenant_id: Active tenant ID from authentication context user_id: Current user ID for auditing Returns: CertificateListResponse: List of certificates Raises: HTTPException 404: If issuer not found or doesn't belong to tenant operationId: list_certificates_issuers__issuer_id__certificates_get parameters: - name: issuer_id in: path required: true schema: type: string format: uuid title: Issuer Id - 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/CertificateListResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: CertificateListResponse: properties: items: items: $ref: '#/components/schemas/CertificateResponse' type: array title: Items total: type: integer title: Total type: object required: - items - total title: CertificateListResponse description: Schema for list of Certificates. example: items: [] total: 0 HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CertificateResponse: properties: id: type: string format: uuid title: Id tenant_id: type: string format: uuid title: Tenant Id issuer_id: type: string format: uuid title: Issuer Id subject_cn: anyOf: - type: string - type: 'null' title: Subject Cn serial_number: anyOf: - type: string - type: 'null' title: Serial Number valid_from: type: string format: date-time title: Valid From valid_until: type: string format: date-time title: Valid Until status: $ref: '#/components/schemas/CertificateStatus' 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 - issuer_id - subject_cn - serial_number - valid_from - valid_until - status - created_at - updated_at title: CertificateResponse description: Schema for Certificate response (without sensitive data). example: created_at: '2024-01-01T00:00:00Z' id: 990e8400-e29b-41d4-a716-446655440000 issuer_id: 550e8400-e29b-41d4-a716-446655440000 serial_number: 1234567890ABCDEF status: active subject_cn: EMPRESA EJEMPLO S.A. tenant_id: 660e8400-e29b-41d4-a716-446655440000 updated_at: '2024-01-01T00:00:00Z' valid_from: '2024-01-01T00:00:00Z' valid_until: '2026-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 CertificateStatus: type: string enum: - uploaded - active - expiring - expired - revoked - disabled title: CertificateStatus description: Status values for digital certificates. ````