> ## 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 usuarios autorizados

> Obtiene la lista de usuarios autorizados para emitir boletas de honorarios, leída desde un caché local. Nunca consulta el SII en el momento del request — para refrescarla contra el SII, usa POST /honorary/master-entities/{master_entity_id}/authorized-users/sync/.



## OpenAPI

````yaml api-reference/openapi-v2.json GET /honorary/master-entities/{master_entity_id}/authorized-users/
openapi: 3.0.0
info:
  title: Tupana API — v2
  description: >-
    API v2 de Tupana: facturación electrónica, cesiones, recaudación, consultas,
    boleta de honorarios y nómina. Los identificadores de recursos son public
    IDs opacos con prefijo (docu_, ment_, cred_, doce_, empl_…).
  version: 2.0.0
servers:
  - url: https://api.tupana.ai/v2
    description: Producción (v2)
security:
  - apiKeyAuth: []
paths:
  /honorary/master-entities/{master_entity_id}/authorized-users/:
    get:
      tags:
        - Honorary
      summary: Listar usuarios autorizados
      description: >-
        Obtiene la lista de usuarios autorizados para emitir boletas de
        honorarios, leída desde un caché local. Nunca consulta el SII en el
        momento del request — para refrescarla contra el SII, usa POST
        /honorary/master-entities/{master_entity_id}/authorized-users/sync/.
      parameters:
        - name: master_entity_id
          in: path
          required: true
          schema:
            type: integer
            description: ID de la entidad maestra
          description: ID de la entidad para la cual se consultan los autorizados
      responses:
        '200':
          description: Lista de usuarios autorizados obtenida exitosamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  authorized_users:
                    type: array
                    items:
                      type: object
                      properties:
                        rut:
                          type: string
                          description: RUT del usuario con formato de puntos y guión
                          example: 12.345.678-9
                        nombre:
                          type: string
                          description: Nombre completo del usuario autorizado
                          example: MARIA JOSEFA GONZALEZ LOPEZ
                        enrolled:
                          type: boolean
                          description: Si el usuario ya está enrolado en el sistema
                          example: false
                      required:
                        - rut
                        - nombre
                        - enrolled
                  last_sync_status:
                    type: string
                    nullable: true
                    enum:
                      - queued
                      - syncing
                      - done
                      - error
                      - null
                    description: >-
                      Estado del último intento de sincronización con el SII.
                      null si esta entidad nunca fue sincronizada.
                    example: done
                  last_sync_error:
                    type: string
                    description: >-
                      Mensaje de error del último intento, solo presente si
                      last_sync_status es 'error'
                    example: ''
                  last_synced_at:
                    type: string
                    format: date-time
                    nullable: true
                    description: >-
                      Fecha y hora (ISO 8601) en que terminó la última
                      sincronización exitosa o fallida. null si ninguna ha
                      terminado todavía.
                    example: '2026-07-22T15:40:12.123456+00:00'
                required:
                  - authorized_users
        '400':
          description: Parámetros inválidos
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Se requiere el parámetro 'master_entity_id'
        '403':
          description: Sin permisos para acceder a la entidad
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Usuario sin permisos para acceder a la entidad
        '404':
          description: Entidad no encontrada o sin credenciales
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: No se encontró una credencial válida para la entidad
        '500':
          description: Error interno del servidor
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Error al obtener usuarios autorizadores
      security:
        - apiKeyAuth: []
components:
  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)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.