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

# Listar Credenciales

> Obtiene todas las activas del usuario autenticado

## Qué hace

* Devuelve todas las credenciales activas del usuario autenticado
* Incluye el estado de validación de cada credencial
* Muestra la fecha de creación de cada credencial
* Lista las entidades maestras asociadas a cada credencial

## Ejemplos de uso

* Verificar qué credenciales están configuradas
* Consultar el estado de validación de las credenciales
* Listar todas las credenciales antes de crear una nueva
* Revisar qué entidades tienen credenciales asociadas

### Estados de Credenciales

* **VALID**: Credencial válida y activa en el SII
* **INVALID**: Credencial con datos incorrectos
* **EXPIRED**: Credencial que ha expirado


## OpenAPI

````yaml GET /credentials
openapi: 3.0.0
info:
  title: Tupana API
  description: API para integración con el sistema Tupana - Facturación Electrónica
  version: 1.0.0
servers:
  - url: https://api.tupana.ai/v1
    description: Servidor de producción
security:
  - apiKeyAuth: []
paths:
  /credentials:
    get:
      tags:
        - Credenciales
      summary: Listar credenciales
      description: Obtiene todas las activas del usuario autenticado
      operationId: listCredentials
      responses:
        '200':
          description: Lista de credenciales obtenida exitosamente
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: integer
                      description: ID único de la credencial
                      example: 245
                    user:
                      type: string
                      description: RUT del usuario de la credencial
                      example: 16659618-1
                    credential_type:
                      type: object
                      description: Tipo de credencial
                      properties:
                        id:
                          type: integer
                          description: ID del tipo de credencial
                          example: 70
                        name:
                          type: string
                          description: Nombre del tipo de credencial
                          example: SII
                    created_at:
                      type: string
                      format: date-time
                      description: Fecha de creación de la credencial
                      example: '2025-08-06T01:24:45.422918Z'
                    status:
                      type: string
                      description: Estado de la credencial
                      enum:
                        - VALID
                        - INVALID
                        - EXPIRED
                      example: VALID
                    master_entities:
                      type: array
                      description: Lista de entidades maestras asociadas a la credencial
                      items:
                        type: object
                        properties:
                          id:
                            type: integer
                            description: ID de la entidad maestra
                            example: 4355
                          name:
                            type: string
                            description: Nombre de la entidad maestra
                            example: HIDDEN CORE SPA
                          tax_id:
                            type: string
                            description: RUT de la entidad maestra
                            example: 78.121.555-4
        '401':
          description: No autorizado - API key inválida o faltante
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: Prohibido - Sin permisos para acceder a credenciales
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - apiKeyAuth: []
components:
  schemas:
    Error:
      required:
        - error
        - message
      type: object
      properties:
        error:
          type: string
          description: Código de error
          example: VALIDATION_ERROR
          enum:
            - VALIDATION_ERROR
            - AUTHENTICATION_ERROR
            - AUTHORIZATION_ERROR
            - NOT_FOUND
            - SII_ERROR
            - INTERNAL_ERROR
        message:
          type: string
          description: Mensaje de error
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        API Key para autenticación. Debe proporcionarse en el header
        Authorization con el formato: 'Api-Key YOUR-API-KEY' (incluye el prefijo
        'Api-Key ' seguido de tu API key)

````