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

# Listar centros con sus servicios y coberturas

> Devuelve todos los centros médicos configurados en marIA con sus servicios y coberturas asociadas.

- Usado para mostrar al paciente los centros disponibles durante una llamada.
- Las coberturas (`benefits`) dentro de cada servicio son las que se usan para agendar citas (`benefitId`).




## OpenAPI

````yaml /openapi/openapi-maria.yaml get /api/v1/centers
openapi: 3.1.0
info:
  title: marIA API
  version: 1.0.0
  description: >
    marIA es el agente de voz de Omniloy que atiende llamadas entrantes de
    pacientes en hospitales y clínicas.

    - Voice / Telefonía: el paciente llama y marIA responde, gestiona citas con
    el EHR/HIS, responde FAQs y escala a humano cuando es necesario.

    - Notificaciones WhatsApp: confirmaciones y recordatorios de cita por
    plantilla aprobada.

    - Centros y servicios: consulta y gestión de centros, especialidades y
    coberturas configuradas en marIA.

    - Base de conocimiento FAQ: documentos que alimentan el conocimiento del
    agente sobre centros y servicios.

    - Llamadas salientes y cuestionarios: programación outbound y cuestionarios
    de seguimiento.

    - Integración EHR/HIS mediante webhooks: marIA ⇄ Hospital para beneficios,
    huecos y citas.

    - Gestión de webhooks: registro y configuración de endpoints para recibir
    eventos de marIA.

    Los webhooks top‑level notifican eventos (p. ej. estado de llamadas, citas)
    firmados con `webhookHmac`.
servers:
  - url: https://{your-prod-endpoint}
    description: Producción
    variables:
      your-prod-endpoint:
        default: your-prod-endpoint
        description: Sustituye este valor por el host real antes de probar la petición.
  - url: https://{your-dev-endpoint}
    description: Staging
    variables:
      your-dev-endpoint:
        default: your-dev-endpoint
        description: Sustituye este valor por el host de staging o desarrollo.
security: []
tags:
  - name: Health
    description: Estado y disponibilidad del servicio.
  - name: Centers
    description: Centros médicos con sus servicios y coberturas configurados en marIA.
  - name: WhatsApp Notifications
    description: Envío de confirmaciones y recordatorios de cita por plantilla de WhatsApp.
  - name: FAQ
    description: >-
      Documentos FAQ para que el agente pueda responder preguntas sobre centros
      y servicios.
  - name: Webhooks - Appointments
    description: Eventos de citas integradas con el EHR/HIS.
  - name: Webhooks - Voice
    description: >-
      Eventos de telefonía (estado de llamada, escalado, respuestas y
      transcripciones).
  - name: Voice Calls
    description: Gestión de llamadas entrantes y salientes registradas en MarIA Core.
  - name: Voice Answers
    description: Acceso y filtrado de respuestas capturadas durante llamadas.
  - name: Voice Transcripts
    description: Acceso a transcripciones y enlaces de grabación.
  - name: Content - Questionnaires
    description: Definición de cuestionarios para llamadas salientes.
  - name: Questionnaire Instances
    description: Estado, revisión y resultados de instancias de cuestionario.
  - name: Scheduling - Time Ranges
    description: Rangos horarios reutilizables para programar llamadas.
  - name: Gestión de webhooks
    description: Configuración y gestión de webhooks; endpoints para integradores.
paths:
  /api/v1/centers:
    get:
      tags:
        - Centers
      summary: Listar centros con sus servicios y coberturas
      description: >
        Devuelve todos los centros médicos configurados en marIA con sus
        servicios y coberturas asociadas.


        - Usado para mostrar al paciente los centros disponibles durante una
        llamada.

        - Las coberturas (`benefits`) dentro de cada servicio son las que se
        usan para agendar citas (`benefitId`).
      operationId: list-centers
      responses:
        '200':
          description: Centros recuperados correctamente
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/CenterWithServicesDto'
              example:
                success: true
                data:
                  - center:
                      id: 1
                      centerName: Centro Norte
                    isSchedulable: true
                    service:
                      id: 10
                      serviceName: Cardiología
                      isSchedulable: true
                      benefits:
                        - id: 101
                          benefitName: Consulta cardiología
                          isSchedulable: true
                          serviceId: 10
        '401':
          description: No autorizado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorDto'
      security:
        - apiKeyAuth: []
components:
  schemas:
    CenterWithServicesDto:
      type: object
      description: Centro médico con su servicio y coberturas asociadas.
      properties:
        center:
          type: object
          properties:
            id:
              type: number
            centerName:
              type: string
          required:
            - id
            - centerName
        isSchedulable:
          type: boolean
        service:
          $ref: '#/components/schemas/ServiceDto'
      required:
        - center
        - isSchedulable
    ErrorDto:
      type: object
      properties:
        status:
          type: string
          enum:
            - error
        code:
          type: integer
        error_code:
          type: string
        message:
          type: string
      required:
        - status
        - code
        - error_code
        - message
    ServiceDto:
      type: object
      description: Especialidad o tipo de servicio con sus coberturas.
      properties:
        id:
          type: number
        serviceName:
          type: string
        isSchedulable:
          type: boolean
        benefits:
          type: array
          items:
            $ref: '#/components/schemas/BenefitDto'
      required:
        - id
        - serviceName
        - isSchedulable
    BenefitDto:
      type: object
      description: Cobertura/prestación dentro de un servicio.
      properties:
        id:
          type: number
        benefitName:
          type: string
        isSchedulable:
          type: boolean
          description: Si se puede agendar cita para esta cobertura.
        serviceId:
          type: number
      required:
        - id
        - benefitName
        - isSchedulable
        - serviceId
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: X-Api-Key
      description: >-
        API Key proporcionada por Omniloy. La misma key se usa para llamadas
        entrantes y salientes.

````