Pacientes — BestDoctorsRD API

GET/v1/patients

Listar pacientes

Parámetros

Nombre	En	Tipo	Obl.
`limit`	query	integer	No
`offset`	query	integer	No
`q`	query	string o nulo	No
`include_total`	query	boolean	No
`clinical_status`	query	string o nulo	No
`approval_status`	query	string o nulo	No
`insurance_name`	query	string o nulo	No
`reconciliation`	query	string o nulo	No
`include_global_approved`	query	boolean	No
`sort_by`	query	string	No
`sort_dir`	query	string	No
`tenant_id`	query	string o nulo	No
`all_tenants`Sólo SUPER_ADMIN: pide EXPLÍCITAMENTE la vista de todas las instituciones. Sin esto y sin tenant_id, la petición se rechaza.	query	boolean	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	lista de PatientSummaryOut o PatientListOut
422	Error de validación	HTTPValidationError

POST/v1/patients

Crear un paciente

Parámetros

Nombre	En	Tipo	Obl.
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `appapiroutespatientsPatientCreateIn`

Campo	Tipo	Obl.
`medical_record_no`	string o nulo	No
`first_name`	string	Sí
`last_name`	string	Sí
`branch_id`	string o nulo	No
`document_type`	string o nulo	No
`document_id`	string o nulo	No
`identity_document_type`	string o nulo	No
`identity_document_number`	string o nulo	No
`emergencyRegistration`	boolean	No
`allowDuplicate`	boolean	No
`duplicateOverrideReason`	string o nulo	No
`email`	string o nulo	No
`phone`	string o nulo	No
`birth_date`	string (date-time) o nulo	No
`gender`	string o nulo	No
`race`	string o nulo	No
`ethnicity`	string o nulo	No
`marital_status`	string o nulo	No
`occupation`	string o nulo	No
`preferred_language`	string o nulo	No
`height_cm`	number o nulo	No
`weightLb`	number o nulo	No
`province`	string o nulo	No
`municipality`	string o nulo	No
`street_address`	string o nulo	No
`primary_doctor_id`	string o nulo	No
`blood_type`	string o nulo	No
`emergency_contact`	string o nulo	No
`emergency_contact_name`	string o nulo	No
`emergency_contact_relationship`	string o nulo	No
`emergency_contact_phone`	string o nulo	No
`emergency_contact_email`	string o nulo	No
`guarantor_name`	string o nulo	No
`guarantor_relationship`	string o nulo	No
`guarantor_document_type`	string o nulo	No
`guarantor_document_id`	string o nulo	No
`guarantor_phone`	string o nulo	No
`guarantor_email`	string o nulo	No
`preferred_pharmacy`	string o nulo	No
`primary_insurance_name`	string o nulo	No
`primary_insurance_policy_number`	string o nulo	No
`primary_insurance_member_number`	string o nulo	No
`primary_insurance_group_number`	string o nulo	No
`primary_insurance_plan_type`	string o nulo	No
`primary_insurance_authorization_number`	string o nulo	No
`conditionNames`	lista de string	No

Respuestas

Código	Descripción	Devuelve
201	Respuesta correcta	app__schemas__patient__PatientOut
422	Error de validación	HTTPValidationError

GET/v1/patients/{patient_id}

Consultar un paciente de la institución por su identificador

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No
`all_tenants`Sólo SUPER_ADMIN: pide EXPLÍCITAMENTE la vista de todas las instituciones. Sin esto y sin tenant_id, la petición se rechaza.	query	boolean	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	PatientDetailOut
422	Error de validación	HTTPValidationError

PATCH/v1/patients/{patient_id}

Actualizar un paciente de la institución

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `PatientUpdateIn`

Campo	Tipo	Obl.
`medical_record_no`	string o nulo	No
`first_name`	string o nulo	No
`last_name`	string o nulo	No
`branch_id`	string o nulo	No
`document_type`	string o nulo	No
`document_id`	string o nulo	No
`identity_document_type`	string o nulo	No
`identity_document_number`	string o nulo	No
`isTemporaryIdentity`	boolean o nulo	No
`identity_reconciliation_status`	string o nulo	No
`updateReason`	string o nulo	No
`email`	string o nulo	No
`phone`	string o nulo	No
`birth_date`	string (date-time) o nulo	No
`gender`	string o nulo	No
`race`	string o nulo	No
`ethnicity`	string o nulo	No
`marital_status`	string o nulo	No
`occupation`	string o nulo	No
`preferred_language`	string o nulo	No
`height_cm`	number o nulo	No
`weightLb`	number o nulo	No
`province`	string o nulo	No
`municipality`	string o nulo	No
`street_address`	string o nulo	No
`primary_doctor_id`	string o nulo	No
`blood_type`	string o nulo	No
`emergency_contact`	string o nulo	No
`emergency_contact_name`	string o nulo	No
`emergency_contact_relationship`	string o nulo	No
`emergency_contact_phone`	string o nulo	No
`emergency_contact_email`	string o nulo	No
`guarantor_name`	string o nulo	No
`guarantor_relationship`	string o nulo	No
`guarantor_document_type`	string o nulo	No
`guarantor_document_id`	string o nulo	No
`guarantor_phone`	string o nulo	No
`guarantor_email`	string o nulo	No
`preferred_pharmacy`	string o nulo	No
`primary_insurance_name`	string o nulo	No
`primary_insurance_policy_number`	string o nulo	No
`primary_insurance_member_number`	string o nulo	No
`primary_insurance_group_number`	string o nulo	No
`primary_insurance_plan_type`	string o nulo	No
`primary_insurance_authorization_number`	string o nulo	No
`conditionNames`	lista de string o nulo	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	app__schemas__patient__PatientOut
422	Error de validación	HTTPValidationError

DELETE/v1/patients/{patient_id}

Eliminar un paciente

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

Código	Descripción	Devuelve
204	Respuesta correcta	—
422	Error de validación	HTTPValidationError

GET/v1/patients/{patient_id}/access-log

Consultar la bitácora de accesos al expediente del paciente

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No
`limit`	query	integer	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	lista de PatientAccessLogEntryOut
422	Error de validación	HTTPValidationError

DELETE/v1/patients/{patient_id}/admin

Eliminar un paciente (administración)

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí

Respuestas

Código	Descripción	Devuelve
204	Respuesta correcta	—
422	Error de validación	HTTPValidationError

GET/v1/patients/{patient_id}/allergies

Listar las alergias del paciente

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	lista de PatientAllergyOut
422	Error de validación	HTTPValidationError

POST/v1/patients/{patient_id}/allergies

Registrar una alergia del paciente

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `PatientAllergyIn`

Campo	Tipo	Obl.
`allergen`	string	Sí
`reaction`	string o nulo	No
`severity`	string o nulo	No
`allergenCode`	string o nulo	No
`kind`	string o nulo	No
`isActive`	boolean	No

Respuestas

Código	Descripción	Devuelve
201	Respuesta correcta	PatientAllergyOut
422	Error de validación	HTTPValidationError

GET/v1/patients/{patient_id}/allergies/food

List Patient Food Allergies

Las alergias ALIMENTARIAS del paciente, con sus familias ya expandidas — CR-494. Es la consulta que va a hacer nutrición, y devuelve `blockedCodes` resuelto a propósito: quien compara un plato contra un paciente lo hace muchas veces —la cola de cocina, por cada bandeja—, y así la comparación es una intersección de conjuntos en vez de subir el árbol en cada pareja. Registrar «camarón» deja bloqueado también «crustáceos» y «mariscos». `unclassified` NO es relleno. Son las alergias sin código y sin tipo: el motor **no sabe** si son alimentarias, y esconderlas dejaría a la cocina creyendo que la lista está completa. Un hueco que no se ve es peor que un hueco.

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	PatientFoodAllergiesOut
422	Error de validación	HTTPValidationError

PATCH/v1/patients/{patient_id}/allergies/{allergy_id}

Actualizar una alergia del paciente

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`allergy_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `PatientAllergyIn`

Campo	Tipo	Obl.
`allergen`	string	Sí
`reaction`	string o nulo	No
`severity`	string o nulo	No
`allergenCode`	string o nulo	No
`kind`	string o nulo	No
`isActive`	boolean	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	PatientAllergyOut
422	Error de validación	HTTPValidationError

PATCH/v1/patients/{patient_id}/approval

Actualizar la aprobación del paciente

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí

Cuerpo obligatorio `PatientApprovalIn`

Campo	Tipo	Obl.
`status`	string	Sí

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	app__schemas__patient__PatientOut
422	Error de validación	HTTPValidationError

GET/v1/patients/{patient_id}/conditions

Listar las condiciones del paciente

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	lista de PatientConditionOut
422	Error de validación	HTTPValidationError

POST/v1/patients/{patient_id}/conditions

Registrar una condición del paciente

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `PatientConditionIn`

Campo	Tipo	Obl.
`conditionName`	string	Sí
`status`	string	No
`notes`	string o nulo	No

Respuestas

Código	Descripción	Devuelve
201	Respuesta correcta	PatientConditionOut
422	Error de validación	HTTPValidationError

PATCH/v1/patients/{patient_id}/conditions/{condition_id}

Actualizar una condición del paciente

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`condition_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `PatientConditionIn`

Campo	Tipo	Obl.
`conditionName`	string	Sí
`status`	string	No
`notes`	string o nulo	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	PatientConditionOut
422	Error de validación	HTTPValidationError

GET/v1/patients/{patient_id}/insurances

Listar los seguros del paciente

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

Código	Descripción	Devuelve
200	Respuesta correcta	lista de PatientInsuranceOut
422	Error de validación	HTTPValidationError

POST/v1/patients/{patient_id}/insurances

Registrar un seguro del paciente

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Cuerpo obligatorio `PatientInsuranceIn`

Campo	Tipo	Obl.
`insuranceName`	string	Sí
`policyNumber`	string o nulo	No
`memberNumber`	string o nulo	No
`groupNumber`	string o nulo	No
`planType`	string o nulo	No
`authorizationNumber`	string o nulo	No
`isPrimary`	boolean	No

Respuestas

Código	Descripción	Devuelve
201	Respuesta correcta	PatientInsuranceOut
422	Error de validación	HTTPValidationError

DELETE/v1/patients/{patient_id}/insurances/{insurance_id}

Eliminar un seguro del paciente

Parámetros

Nombre	En	Tipo	Obl.
`patient_id`	path	string	Sí
`insurance_id`	path	string	Sí
`tenant_id`	query	string o nulo	No

Respuestas

Código	Descripción	Devuelve
204	Respuesta correcta	—
422	Error de validación	HTTPValidationError

Listar pacientes

Parámetros

Respuestas

Crear un paciente

Parámetros

Cuerpo obligatorio app__api__routes__patients__PatientCreateIn

Respuestas

Consultar un paciente de la institución por su identificador

Parámetros

Respuestas

Actualizar un paciente de la institución

Parámetros

Cuerpo obligatorio PatientUpdateIn

Respuestas

Eliminar un paciente

Parámetros

Respuestas

Consultar la bitácora de accesos al expediente del paciente

Parámetros

Respuestas

Eliminar un paciente (administración)

Parámetros

Respuestas

Listar las alergias del paciente

Parámetros

Respuestas

Registrar una alergia del paciente

Parámetros

Cuerpo obligatorio PatientAllergyIn

Respuestas

List Patient Food Allergies

Parámetros

Respuestas

Actualizar una alergia del paciente

Parámetros

Cuerpo obligatorio PatientAllergyIn

Respuestas

Actualizar la aprobación del paciente

Parámetros

Cuerpo obligatorio PatientApprovalIn

Respuestas

Listar las condiciones del paciente

Parámetros

Respuestas

Registrar una condición del paciente

Parámetros

Cuerpo obligatorio PatientConditionIn

Respuestas

Actualizar una condición del paciente

Parámetros

Cuerpo obligatorio PatientConditionIn

Respuestas

Listar los seguros del paciente

Parámetros

Respuestas

Registrar un seguro del paciente

Parámetros

Cuerpo obligatorio PatientInsuranceIn

Respuestas

Eliminar un seguro del paciente

Parámetros

Respuestas

Cuerpo obligatorio `appapiroutespatientsPatientCreateIn`

Cuerpo obligatorio `PatientUpdateIn`

Cuerpo obligatorio `PatientAllergyIn`

Cuerpo obligatorio `PatientAllergyIn`

Cuerpo obligatorio `PatientApprovalIn`

Cuerpo obligatorio `PatientConditionIn`

Cuerpo obligatorio `PatientConditionIn`

Cuerpo obligatorio `PatientInsuranceIn`