Skip to main content

Obtener Informes por Usuario y Proveedor

Este endpoint permite a un proveedor de salud (Health Provider) recuperar una lista de citas médicas. Si en los parámetros de consulta (query params) se incluye únicamente el providerId, se obtendrán todas las citas asociadas al centro médico. En cambio, si también se incluye un userId, se filtrarán las citas correspondientes únicamente a ese usuario dentro del mismo proveedor.

🔒 Este endpoint requiere autenticación. Consulte la sección de Autenticación para obtener su token y cómo utilizarlo en la cabecera Authorization.

Endpoint​

💡 Importante: Para conocer en detalle los métodos, parámetros requeridos, el formato del body y posibles respuestas, puede consultar la documentación específica en el Portal de desarrolladores o revisar el request configurado en el archivo de Postman previamente compartido.

🔐 Nota: Para obtener el catálogo de HealthAPI, debe autenticarse en ese mismo portal utilizando las credenciales otorgadas.

A continuación se detallan los parámetros necesarios.

Parámetros de Consulta (Query)​

ParámetroTipoObligatorioDescripción
userIdstringNoIdentificador único del usuario dentro del Health Provider.
providerIdnumberSíIdentificador único del Health Provider.
includeApprovedbooleanNoSi no se incluye, se devuelven todos los informes. Si es true, solo los aprobados. Si es false, solo los no aprobados.
limitnumberNoNúmero máximo de resultados por página. Por defecto es 10. Máximo permitido: 100.
offsetnumberNoPosición desde la cual comenzar a mostrar resultados (basado en índice cero). Por defecto: 0.

📘 Para más detalles, consulte la sección de Paginación.

Ejemplos de uso y respuesta​

✅ Obtener todos los informes del Health Provider​

GET /medicalAppointment?providerId=123&limit=3

Ejemplo de Respuesta Exitosa (200 OK):

{
  "success": true,
  "code": 200,
  "response": {
    "data": [
      {
        "providerId": "123",
        "id": "rep_001",
        "approved": true,
        "medicalReport": {
          "AUDIO_LANGUAGE": "Spanish",
          "MEDICAL_OUTPUT": {
            "report": "# Informe Consulta Médica\n\n**Motivo de Consulta:** Dolor abdominal persistente.\n\n**Síntomas:** Dolor en zona baja del abdomen, náuseas leves.\n\n**Historia Personal:** Sin antecedentes relevantes.\n\n**Historia Familiar:** Madre con antecedentes de gastritis.\n\n**Exploración Física:** Dolor leve a la palpación en zona hipogástrica.\n\n**Diagnóstico:** Posible gastroenteritis.\n\n**Tratamiento Prescrito:** Reposo, dieta blanda y paracetamol si el dolor aumenta.\n\n**Exámenes Solicitados:** Ninguno por el momento.\n\n**Derivaciones:** No se requiere.\n\n**Receta Médica:** Paracetamol 500 mg cada 8 horas si hay dolor.",
            "summary": "Consulta por dolor abdominal. Diagnóstico presuntivo de gastroenteritis. Se indica reposo, dieta blanda y paracetamol según necesidad."
          }
        },
        "datetime": "2025-08-01T14:30:00.000Z",
        "reportExampleId": 101,
        "status": "GENERATED",
        "userId": "u001"
      },
      {
        "providerId": "123",
        "id": "rep_002",
        "approved": true,
        "medicalReport": {
          "AUDIO_LANGUAGE": "Spanish",
          "MEDICAL_OUTPUT": {
            "report": "# Informe Consulta Médica\n\n**Motivo de Consulta:** Control post operatorio.\n\n**Síntomas:** Sin síntomas actuales.\n\n**Historia Personal:** Cirugía de apendicitis hace 10 días.\n\n**Historia Familiar:** No relevante para el cuadro actual.\n\n**Exploración Física:** Cicatriz quirúrgica sin signos de infección. Abdomen blando y depresible.\n\n**Diagnóstico:** Postoperatorio sin complicaciones.\n\n**Tratamiento Prescrito:** Continuar con curaciones locales.\n\n**Exámenes Solicitados:** No se solicitan.\n\n**Derivaciones:** No se requiere.\n\n**Receta Médica:** No se prescribe medicación.",
            "summary": "Control post operatorio sin complicaciones. Cicatriz en buen estado. No se requiere tratamiento adicional."
          }
        },
        "datetime": "2025-08-01T14:35:00.000Z",
        "reportExampleId": 102,
        "status": "GENERATED",
        "userId": "u002"
      },
      {
        "providerId": "123",
        "id": "rep_003",
        "approved": true,
        "medicalReport": {
          "AUDIO_LANGUAGE": "Spanish",
          "MEDICAL_OUTPUT": {
            "report": "# Informe Consulta Médica\n\n**Motivo de Consulta:** Dolor lumbar intenso.\n\n**Síntomas:** Dolor irradiado hacia pierna izquierda.\n\n**Historia Personal:** Lumbalgia recurrente.\n\n**Historia Familiar:** Padre con hernia discal.\n\n**Exploración Física:** Dolor a la movilización lumbar, prueba de Lasègue positiva.\n\n**Diagnóstico:** Lumbociatalgia izquierda.\n\n**Tratamiento Prescrito:** Ibuprofeno 600 mg cada 8 horas por 5 días.\n\n**Exámenes Solicitados:** Resonancia lumbar.\n\n**Derivaciones:** Traumatología.\n\n**Receta Médica:** Ibuprofeno 600 mg cada 8 horas por 5 días.",
            "summary": "Paciente con dolor lumbar irradiado. Diagnóstico de lumbociatalgia. Se indica tratamiento antiinflamatorio y estudio por resonancia."
          }
        },
        "datetime": "2025-08-01T14:40:00.000Z",
        "reportExampleId": 103,
        "status": "GENERATED",
        "userId": "u003"
      }
    ],
    "meta": {
      "total": 42,
      "offset": 0,
      "limit": 3
    }
  }
}

✅ Obtener todos los informes de un usuario específico​

GET /medicalAppointment?providerId=123&limit=3&userId=321

Ejemplo de Respuesta Exitosa (200 OK):

{
  "success": true,
  "code": 200,
  "response": {
    "data": [
      {
        "providerId": "123",
        "id": "rep_004",
        "approved": true,
        "medicalReport": {
          "AUDIO_LANGUAGE": "Spanish",
          "MEDICAL_OUTPUT": {
            "report": "# Informe Consulta Médica\n\n**Motivo de Consulta:** Consulta de control por hipertensión.\n\n**Anamnesis próxima:**\n\nEl paciente refiere que ha mantenido la dieta baja en sodio y tomado su medicación regularmente. Niega mareos o cefaleas.\n\n**Anamnesis Remota:**\n\nHipertensión diagnosticada hace 2 años. No antecedentes de diabetes ni dislipidemia.\n\n**Diagnóstico:** Hipertensión arterial controlada.\n\n**Tratamiento Prescrito:** Continuar con losartán 50 mg una vez al día.\n\n**Exámenes Solicitados:** Presión arterial en domicilio durante 1 semana.\n\n**Derivaciones:** No requiere.\n\n**Receta Médica:** Losartán 50 mg, tomar una vez al día.",
            "summary": "Control de hipertensión. El paciente mantiene buena adherencia. Se indica continuar con losartán y monitoreo domiciliario de presión arterial."
          }
        },
        "datetime": "2025-08-01T15:00:00.000Z",
        "reportExampleId": 101,
        "status": "GENERATED"
      },
      {
        "providerId": "123",
        "id": "rep_005",
        "approved": true,
        "medicalReport": {
          "AUDIO_LANGUAGE": "Spanish",
          "MEDICAL_OUTPUT": {
            "report": "# Informe Consulta Médica\n\n**Motivo de Consulta:** Revisión ginecológica anual.\n\n**Anamnesis próxima:**\n\nLa paciente no refiere molestias actuales. Última menstruación hace 3 semanas, regular.\n\n**Anamnesis Remota:**\n\nSin antecedentes patológicos relevantes. Pap previo normal.\n\n**Diagnóstico:** Revisión anual sin hallazgos anormales.\n\n**Tratamiento Prescrito:** No requiere.\n\n**Exámenes Solicitados:** PAP y ecografía transvaginal de control.\n\n**Derivaciones:** No requiere.\n\n**Receta Médica:** No se prescribe medicación.",
            "summary": "Revisión ginecológica anual. Sin hallazgos patológicos. Se solicitan exámenes de control."
          }
        },
        "datetime": "2025-08-01T15:05:00.000Z",
        "reportExampleId": 102,
        "status": "GENERATED"
      },
      {
        "providerId": "123",
        "id": "rep_006",
        "approved": false,
        "medicalReport": {
          "AUDIO_LANGUAGE": "Spanish",
          "MEDICAL_OUTPUT": {
            "report": "# Informe Consulta Médica\n\n**Motivo de Consulta:** Fiebre y dolor corporal desde hace 2 días.\n\n**Anamnesis próxima:**\n\nPaciente refiere fiebre de hasta 39°C, mialgias generalizadas y cefalea. No hay síntomas respiratorios.\n\n**Anamnesis Remota:**\n\nVacunación COVID completa. No antecedentes de enfermedades crónicas.\n\n**Exploración Física:** Se detectan signos de proceso viral, sin focalidad. \n\n**Diagnóstico:** Cuadro viral inespecífico.\n\n**Tratamiento Prescrito:** Paracetamol cada 8 horas según necesidad. Reposo e hidratación.\n\n**Exámenes Solicitados:** No se solicitan por el momento.\n\n**Derivaciones:** No se indica.\n\n**Receta Médica:** Paracetamol 500 mg, cada 8 horas si hay fiebre o dolor.",
            "summary": "Fiebre y mialgias. Diagnóstico de cuadro viral. Se indica reposo, paracetamol e hidratación."
          }
        },
        "datetime": "2025-08-01T15:10:00.000Z",
        "reportExampleId": 103,
        "status": "GENERATED"
      }
    ],
    "meta": {
      "total": 39,
      "offset": 0,
      "limit": 3
    }
  }
}

✅ Obtener solo informes no aprobados de un usuario​

GET /medicalAppointment?providerId=123&limit=3&userId=321&includeApproved=false

Ejemplo de Respuesta Exitosa (200 OK):

{
  "success": true,
  "code": 200,
  "response": {
    "data": [
      {
        "providerId": "123",
        "id": "rep_007",
        "approved": false,
        "medicalReport": {
          "AUDIO_LANGUAGE": "Spanish",
          "MEDICAL_OUTPUT": {
            "report": "# Informe Consulta Médica\n\n**Motivo de Consulta:** Consulta de control por hipertensión.\n\n**Anamnesis próxima:**\n\nEl paciente refiere que ha mantenido la dieta baja en sodio y tomado su medicación regularmente. Niega mareos o cefaleas.\n\n**Anamnesis Remota:**\n\nHipertensión diagnosticada hace 2 años. No antecedentes de diabetes ni dislipidemia.\n\n**Diagnóstico:** Hipertensión arterial controlada.\n\n**Tratamiento Prescrito:** Continuar con losartán 50 mg una vez al día.\n\n**Exámenes Solicitados:** Presión arterial en domicilio durante 1 semana.\n\n**Derivaciones:** No requiere.\n\n**Receta Médica:** Losartán 50 mg, tomar una vez al día.",
            "summary": "Control de hipertensión. El paciente mantiene buena adherencia. Se indica continuar con losartán y monitoreo domiciliario de presión arterial."
          }
        },
        "datetime": "2025-08-01T15:20:00.000Z",
        "reportExampleId": 101,
        "status": "GENERATED"
      },
      {
        "providerId": "123",
        "id": "rep_008",
        "approved": false,
        "medicalReport": {
          "AUDIO_LANGUAGE": "Spanish",
          "MEDICAL_OUTPUT": {
            "report": "# Informe Consulta Médica\n\nMotivo de Consulta: Cefalea leve recurrente.\n\nAntecedentes Médicos: No disponibles.\n\nAntecedentes Quirúrgicos: No disponibles.\n\nFármacos: No se especifican.\n\nHábitos: No disponibles.\n\nAlergias y/o Reacciones Adversas a Fármacos: No se especifican.\n\nAntecedentes Familiares: No disponibles.\n\nHistoria Clínica: Cefalea ocasional, sin otros síntomas neurológicos asociados.\n\nExamen Físico: No realizado.\n\nPlanes: Indicar paracetamol si es necesario. Control en caso de persistencia o aumento de la intensidad.",
            "summary": "Consulta por cefalea leve. Se prescribe analgésico según necesidad y se sugiere control si persiste."
          }
        },
        "datetime": "2025-08-01T15:25:00.000Z",
        "reportExampleId": 101,
        "status": "GENERATED"
      },
      {
        "providerId": "123",
        "id": "rep_009",
        "approved": false,
        "medicalReport": {
          "AUDIO_LANGUAGE": "Spanish",
          "MEDICAL_OUTPUT": {
            "report": "# Informe Consulta Médica\n\n**Motivo de Consulta:** Consulta de control por hipertensión.\n\n**Anamnesis próxima:**\n\nEl paciente refiere que ha mantenido la dieta baja en sodio y tomado su medicación regularmente. Niega mareos o cefaleas.\n\n**Anamnesis Remota:**\n\nHipertensión diagnosticada hace 2 años. No antecedentes de diabetes ni dislipidemia.\n\n**Diagnóstico:** Hipertensión arterial controlada.\n\n**Tratamiento Prescrito:** Continuar con losartán 50 mg una vez al día.\n\n**Exámenes Solicitados:** Presión arterial en domicilio durante 1 semana.\n\n**Derivaciones:** No requiere.\n\n**Receta Médica:** Losartán 50 mg, tomar una vez al día.",
            "summary": "Control de hipertensión. El paciente mantiene buena adherencia. Se indica continuar con losartán y monitoreo domiciliario de presión arterial."
          }
        },
        "datetime": "2025-08-01T15:30:00.000Z",
        "reportExampleId": 101,
        "status": "GENERATED"
      }
    ],
    "meta": {
      "total": 25,
      "offset": 0,
      "limit": 3
    }
  }
}

✅ Obtener solo informes aprobados de un usuario​

GET /medicalAppointment?providerId=123&limit=3&userId=321&includeApproved=true

Ejemplo de Respuesta Exitosa (200 OK):

{
  "success": true,
  "code": 200,
  "response": {
    "data": [
      {
        "providerId": "123",
        "id": "rep_010",
        "approved": true,
        "medicalReport": {
          "AUDIO_LANGUAGE": "Spanish",
          "MEDICAL_OUTPUT": {
            "report": "# Informe Consulta Médica\n\n**Motivo de Consulta:** Consulta de control por hipertensión.\n\n**Anamnesis próxima:**\n\nEl paciente refiere que ha mantenido la dieta baja en sodio y tomado su medicación regularmente. Niega mareos o cefaleas.\n\n**Anamnesis Remota:**\n\nHipertensión diagnosticada hace 2 años. No antecedentes de diabetes ni dislipidemia.\n\n**Diagnóstico:** Hipertensión arterial controlada.\n\n**Tratamiento Prescrito:** Continuar con losartán 50 mg una vez al día.\n\n**Exámenes Solicitados:** Presión arterial en domicilio durante 1 semana.\n\n**Derivaciones:** No requiere.\n\n**Receta Médica:** Losartán 50 mg, tomar una vez al día.",
            "summary": "Control de hipertensión. El paciente mantiene buena adherencia. Se indica continuar con losartán y monitoreo domiciliario de presión arterial."
          }
        },
        "datetime": "2025-07-30T02:58:54.557Z",
        "reportExampleId": 1947,
        "status": "GENERATED"
      },
      {
        "providerId": "123",
        "id": "rep_011",
        "approved": true,
        "medicalReport": {
          "AUDIO_LANGUAGE": "Spanish",
          "MEDICAL_OUTPUT": {
            "report": "# Informe Consulta Médica\n\n**Motivo de Consulta:** Consulta de control por hipertensión.\n\n**Anamnesis próxima:**\n\nEl paciente refiere que ha mantenido la dieta baja en sodio y tomado su medicación regularmente. Niega mareos o cefaleas.\n\n**Anamnesis Remota:**\n\nHipertensión diagnosticada hace 2 años. No antecedentes de diabetes ni dislipidemia.\n\n**Diagnóstico:** Hipertensión arterial controlada.\n\n**Tratamiento Prescrito:** Continuar con losartán 50 mg una vez al día.\n\n**Exámenes Solicitados:** Presión arterial en domicilio durante 1 semana.\n\n**Derivaciones:** No requiere.\n\n**Receta Médica:** Losartán 50 mg, tomar una vez al día.",
            "summary": "Control de hipertensión. El paciente mantiene buena adherencia. Se indica continuar con losartán y monitoreo domiciliario de presión arterial."
          }
        },
        "datetime": "2025-07-30T02:57:15.952Z",
        "reportExampleId": 1947,
        "status": "GENERATED"
      },
      {
        "providerId": "123",
        "id": "rep_012",
        "approved": true,
        "medicalReport": {
          "AUDIO_LANGUAGE": "Spanish",
          "MEDICAL_OUTPUT": {
            "report": "# Informe Consulta Médica\n\n**Motivo de Consulta:** Consulta de control por hipertensión.\n\n**Anamnesis próxima:**\n\nEl paciente refiere que ha mantenido la dieta baja en sodio y tomado su medicación regularmente. Niega mareos o cefaleas.\n\n**Anamnesis Remota:**\n\nHipertensión diagnosticada hace 2 años. No antecedentes de diabetes ni dislipidemia.\n\n**Diagnóstico:** Hipertensión arterial controlada.\n\n**Tratamiento Prescrito:** Continuar con losartán 50 mg una vez al día.\n\n**Exámenes Solicitados:** Presión arterial en domicilio durante 1 semana.\n\n**Derivaciones:** No requiere.\n\n**Receta Médica:** Losartán 50 mg, tomar una vez al día.",
            "summary": "Control de hipertensión. El paciente mantiene buena adherencia. Se indica continuar con losartán y monitoreo domiciliario de presión arterial."
          }
        },
        "datetime": "2025-07-30T02:39:40.946Z",
        "reportExampleId": 101,
        "status": "GENERATED"
      }
    ],
    "meta": {
      "total": 14,
      "offset": 0,
      "limit": 3
    }
  }
}