Download OpenAPI specification:Download
MiPaciente API-GW endpoints
Notes:
| personId required | string <uuid> Example: 609a003f-a364-4cfe-98cb-8b0505c081c2 |
| organizationId required | string <uuid> Example: organizationId=9e366ad4-1cd3-42ed-8564-25f3725e94ba |
{- "problem": null,
- "ok": true,
- "status": 200,
- "data": [
- {
- "id": "8dc2b603-0e9c-4a4b-86b7-3eaf7101f036",
- "organizationId": "5731cd5f-6d33-41bd-901d-1aea1030f9c8",
- "patientId": "5731cd5f-6d33-41bd-901d-1aea1030f9c8",
- "reason": "Bad",
- "startDate": "2020-05-15T00:00:00.000Z",
- "endDate": "2020-05-15T00:00:00.000Z",
- "reasonClinicalDischarge": "PATIENT DIED",
- "healthProgram": {
- "id": "7ae6c05b-513e-4778-bfb5-b32ce833517d",
- "name": "Hipertensión"
}, - "gatewaysAssigned": [
- {
- "id": "c7f3df33-c547-4e73-9b52-2d8e1d264d71",
- "organizationGateway": {
- "id": "20f43bbc-d839-422e-9fd4-d0118ba72cd4",
- "gateway": {
- "id": "a15c7e34-ba3d-4b81-ab5b-adefa56de3d0",
- "name": "Kit 301",
- "mac": "gw_6c495e7b"
}
}
}
]
}
]
}This endpoint returns one admission, including the health program and the assigned gateway information. If there is no associated health program, and no gateway assigned, these values will be null.
| admissionId required | string <uuid> Example: 609a003f-a364-4cfe-98cb-8b0505c081c2 |
{- "problem": null,
- "ok": true,
- "status": 200,
- "data": {
- "id": "8dc2b603-0e9c-4a4b-86b7-3eaf7101f036",
- "organizationId": "5731cd5f-6d33-41bd-901d-1aea1030f9c8",
- "patientId": "5731cd5f-6d33-41bd-901d-1aea1030f9c8",
- "reason": "Bad",
- "startDate": "2020-05-15T00:00:00.000Z",
- "endDate": "2020-05-15T00:00:00.000Z",
- "reasonClinicalDischarge": "PATIENT DIED",
- "healthProgram": {
- "id": "7ae6c05b-513e-4778-bfb5-b32ce833517d",
- "name": "Hipertensión"
}, - "gatewaysAssigned": [
- {
- "id": "c7f3df33-c547-4e73-9b52-2d8e1d264d71",
- "organizationGateway": {
- "id": "20f43bbc-d839-422e-9fd4-d0118ba72cd4",
- "gateway": {
- "id": "a15c7e34-ba3d-4b81-ab5b-adefa56de3d0",
- "name": "Kit 301",
- "mac": "gw_6c495e7b"
}
}
}
], - "lastObservationDate": "2020-05-15T00:00:00.000Z"
}
}This endpoint finish the admission and unbinds the gateway that was assigned.
| admissionId required | string <uuid> Example: 000b83dd-64ff-4212-921e-f9299e86ad49 |
| reasonClinicalDischarge required | string |
{- "reasonClinicalDischarge": "Razones por las que el paciente finalizó su participación en el programa."
}{- "problem": null,
- "ok": true,
- "status": 200,
- "data": {
- "id": "8dc2b603-0e9c-4a4b-86b7-3eaf7101f036",
- "organizationId": "be42fe6e-940e-4b0f-bd9a-38ffcaa7968b",
- "patientId": "d47f2d13-a138-4b74-9de3-a5b0e44815f2",
- "healthProgramId": "426e85e9-0933-4b62-9835-30bd9e14c1e7",
- "reason": "Bad",
- "startDate": "2020-05-15T00:00:00.000Z",
- "endDate": "2020-05-15T00:00:00.000Z",
- "expectedEndDate": "2020-08-15T00:00:00.000Z",
- "reasonClinicalDischarge": "El paciente decidió abandonar el tratamiento."
}
}| admissionId required | string <uuid> Example: 609a003f-a364-4cfe-98cb-8b0505c081c2 |
{- "problem": null,
- "ok": true,
- "status": 200,
- "data": [
- {
- "medicalDeviceId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "admissionId": "0283e711-d815-4b69-8948-6ed70f0696a8",
- "ieee11073VariableTypeId": "d4c307a9-07c9-47ad-8380-2867446a2205",
- "variableType": "mdc_press_bld_noninv_dia",
- "value": 80,
- "samplingDate": "2019-08-24T14:15:22Z",
- "context": {
- "mac": "F83331B3D1D2",
- "rssi": -67,
- "battery": 100
}, - "id": "c1a2190d-3635-4301-979f-bcb980661c5d"
}
]
}| admissionId required | string <uuid> Example: 609a003f-a364-4cfe-98cb-8b0505c081c2 |
An array of organizationGatewayId
An array of organizationGatewayId
[- "c0f889ab-e466-4be9-a88e-d291ea344381",
- "c0f889ab-e466-4be9-a88e-d291ea344382",
- "c0f889ab-e466-4be9-a88e-d291ea344383"
]{- "problem": null,
- "ok": true,
- "status": 200,
- "data": {
- "gatewaysAssigned": [
- {
- "admissionId": "609a003f-a364-4cfe-98cb-8b0505c081c2",
- "organizationGatewayId": "5aab7ee5-b530-4547-845f-b37ec68e3689",
- "assignationDate": "2019-08-24T14:15:22Z",
- "returnedDate": null,
- "isActive": true,
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null
}
]
}
}If isFailing: true, a returnReason must be sent. If isFailing: false, returnReason must not be sent.
| admissionId required | string <uuid> Example: 609a003f-a364-4cfe-98cb-8b0505c081c2 |
| organizationGatewayId required | string <uuid> Example: 5aab7ee5-b530-4547-845f-b37ec68e3689 |
| isFailing | boolean |
| returnReason | string |
{- "isFailing": true,
- "returnReason": "Descripción de la falla por la que se desvincula el gateway"
}{- "problem": null,
- "ok": true,
- "status": 200,
- "data": {
- "admissionId": "609a003f-a364-4cfe-98cb-8b0505c081c2",
- "organizationGatewayId": "5aab7ee5-b530-4547-845f-b37ec68e3689",
- "assignationDate": "2019-08-24T14:15:22Z",
- "returnedDate": null,
- "isActive": true,
- "gatewayReturnReason": {
- "isFailing": true,
- "returnReason": "Descripción de la falla por la que se desvincula el gateway",
- "gatewayAssignedId": "be42fe6e-940e-4b0f-bd9a-38ffcaa7968b",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null
}, - "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null
}
}| organizationId required | string <uuid> Example: 609a003f-a364-4cfe-98cb-8b0505c081c2 |
| gatewayId required | string <uuid> Example: 5aab7ee5-b530-4547-845f-b37ec68e3689 |
{- "problem": null,
- "ok": true,
- "status": 200,
- "data": {
- "organizationId": "be42fe6e-940e-4b0f-bd9a-38ffcaa7968b",
- "gatewayId": "5f37230c-c497-4f69-bcde-5058b5dec4e8",
- "borrowedDate": "2019-08-24T14:15:22Z",
- "returnedDate": null,
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null
}
}If the gateway is assign to an active admission this action is not allowed.
| organizationId required | string <uuid> Example: 609a003f-a364-4cfe-98cb-8b0505c081c2 |
| gatewayId required | string <uuid> Example: 5aab7ee5-b530-4547-845f-b37ec68e3689 |
{- "problem": null,
- "ok": true,
- "status": 200,
- "data": {
- "organizationId": "be42fe6e-940e-4b0f-bd9a-38ffcaa7968b",
- "gatewayId": "5f37230c-c497-4f69-bcde-5058b5dec4e8",
- "borrowedDate": "2019-08-24T14:15:22Z",
- "returnedDate": null,
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null
}
}Add new patient/person/admission or patient/admission if the person already exists.
| organizationId required | string <uuid> Example: organizationId=609a003f-a364-4cfe-98cb-8b0505c081c2 |
| healthInsuranceEntityId | string <uuid> |
| privateHealthInsuranceId | string <uuid> |
| occupationCodeId | string <uuid> |
Array of objects (newAdmission) | |
required | object (newPerson) |
{- "healthInsuranceEntityId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "privateHealthInsuranceId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "occupationCodeId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "admissions": [
- {
- "patientId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "organizationId": "be42fe6e-940e-4b0f-bd9a-38ffcaa7968b",
- "reason": "Razones por las que el paciente llegó a consulta y los principales hallazgos.",
- "healthProgramId": "524fa56c-4afa-4827-867e-147a1963dc88",
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z",
- "expectedEndDate": "2019-08-24T14:15:22Z",
- "reasonClinicalDischarge": "Razones por las que el paciente finalizó su participación en el programa."
}
], - "person": {
- "names": "Alice",
- "lastnames": "Pérez García",
- "organizationId": "be42fe6e-940e-4b0f-bd9a-38ffcaa7968b",
- "nationalityId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "residenceCountryId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "residenceMunicipalityId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "documentTypeId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "document": "string",
- "birthdate": "2019-08-24",
- "ethnicityId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "ethnicCommunityId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "sexId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "genderId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "address": "Cq. 1 #73-76, Medellín, Antioquia",
- "phone": "604-5534578",
- "settlementTypeId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "disabilityId": "51607348-9123-41b2-a573-10fbc1bb9e19",
- "email": "prueba@local.com"
}
}{- "problem": null,
- "ok": true,
- "status": 200,
- "data": [
- {
- "personId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "healthInsuranceEntityId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "privateHealthInsuranceId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "occupationCodeId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "admissions": [
- {
- "patientId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "organizationId": "be42fe6e-940e-4b0f-bd9a-38ffcaa7968b",
- "reason": "Razones por las que el paciente llegó a consulta y los principales hallazgos.",
- "healthProgramId": "524fa56c-4afa-4827-867e-147a1963dc88",
- "startDate": "2019-08-24T14:15:22Z",
- "endDate": "2019-08-24T14:15:22Z",
- "expectedEndDate": "2019-08-24T14:15:22Z",
- "reasonClinicalDischarge": "Razones por las que el paciente finalizó su participación en el programa.",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null
}
], - "person": {
- "names": "Alice",
- "lastnames": "Pérez García",
- "organizationId": "be42fe6e-940e-4b0f-bd9a-38ffcaa7968b",
- "nationalityId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "residenceCountryId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "residenceMunicipalityId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "documentTypeId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "document": "string",
- "birthdate": "2019-08-24",
- "ethnicityId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "ethnicCommunityId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "sexId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "genderId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "address": "Cq. 1 #73-76, Medellín, Antioquia",
- "phone": "604-5534578",
- "settlementTypeId": "c1a2190d-3635-4301-979f-bcb980661c5d",
- "disabilityId": "51607348-9123-41b2-a573-10fbc1bb9e19",
- "email": "prueba@local.com",
- "fullName": "Alice Pérez García",
- "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null
}, - "healthInsuranceEntity": {
- "epsId": "b8f0a087-fb6a-4a8d-95a0-1d0bae493b1f",
- "regimeTypeId": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "code": "RES014"
}, - "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
- "createdAt": "2019-08-24T14:15:22Z",
- "updatedAt": "2019-08-24T14:15:22Z",
- "deletedAt": null
}
]
}Note: This endpoint return a json with all patients of the organization, their admissions and associated gateways.
| organizationId required | string <uuid> Example: organizationId=9e366ad4-1cd3-42ed-8564-25f3725e94ba |
{- "problem": null,
- "ok": true,
- "status": 200,
- "data": [
- {
- "patient": {
- "id": "9a543b9c-2ced-44db-8935-78cbeeb8c02f",
- "personId": "2129f812-0f44-4690-bc58-b7a6b9c25da9",
- "documentType": "Cédula de ciudadanía",
- "documentNumber": "335677888",
- "name": "Rosa Perez",
- "birthdate": "1998-01-01",
- "sex": "Cédula de ciudadanía"
}, - "healthProgram": {
- "id": "7a992eb9-fccf-4a49-a4c8-ef007009cf84",
- "name": "Hipertensión"
}, - "admission": {
- "id": "4dd2137c-9a4c-47fc-b99b-8d595c40b2c0",
- "startDate": "2022-08-12T12:00:00.000Z",
- "endDate": "",
- "admissionState": "Abierta"
}, - "gateways": [
- {
- "id": "706230c8-ff4f-448b-a1bc-acac12e72e92",
- "name": "Kit 303",
- "mac": "gw_579de10f"
}, - {
- "id": "829362e6-0706-4a6c-99e6-598454a14c9f",
- "name": "Kit 304",
- "mac": "gw_825e3abd"
}
]
}, - {
- "patient": {
- "id": "0c6c8bba-5856-4aa1-a806-07315d044143",
- "personId": "aca3c2d9-8f80-4b07-b414-c0e8e94ccb16",
- "documentType": "Cédula de ciudadanía",
- "documentNumber": "58266555",
- "name": "Pedro Ruiz",
- "birthdate": "1981-01-08",
- "sex": "Cédula de ciudadanía"
}, - "healthProgram": {
- "id": "7a992eb9-fccf-4a49-a4c8-ef007009cf84",
- "name": "Diabetes"
}, - "admission": {
- "id": "37d7ab7e-6997-4911-bf6c-9d176dbb3033",
- "startDate": "2022-08-12T12:00:00.000Z",
- "endDate": "",
- "admissionState": "Abierta"
}, - "gateways": [
- {
- "id": "67218fb0-da99-4ac6-bf21-0409251ac07d",
- "name": "Kit 302",
- "mac": "gw_bd98e396"
}
]
}
]
}Note: This endpoint return a json with all patients of the organization, their admissions and observations.
| startDate required | string <date-time> Example: startDate=2022-02-08T05:00:18.573Z Initial date of the report. This date corresponds to the admission's start date. |
| finalDate required | string <date-time> Example: finalDate=2022-07-08T05:00:18.573Z Final date of the report. |
| organizationId required | string <uuid> Example: organizationId=9e366ad4-1cd3-42ed-8564-25f3725e94ba |
{- "problem": null,
- "ok": true,
- "status": 200,
- "data": {
- "organization": {
- "id": "decf2ea7-3776-42ae-8db7-8c1117d0d5c5",
- "name": "SURA LOS MOLINOS"
}, - "admissions": [
- {
- "id": "0e9cfb3a-d8d2-468d-94ad-748a3be51409",
- "startDate": "",
- "endDate": "",
- "patient": {
- "id": "a784e4a8-4c76-4de1-9930-63f9e9991a09",
- "documentType": "Cédula de ciudadanía",
- "documentNumber": "125458553",
- "name": "Pepito Perez"
}, - "healthProgram": {
- "id": "70ad1401-3c6b-44a1-bd0f-0a50fcca6301",
- "name": "Hipertensión"
}, - "observations": [
- {
- "value": 108,
- "samplingDate": "2024-06-29T11:00:00.000Z",
- "variableType": "mdc_press_bld_nxband_sys",
- "variableName": "Presión sistólica (banda)"
}, - {
- "value": 58,
- "samplingDate": "2024-06-29T11:00:00.000Z",
- "variableType": "mdc_puls_rate_nxband",
- "variableName": "Frecuencia de pulso (banda)"
}, - {
- "value": 70,
- "samplingDate": "2024-06-29T11:00:00.000Z",
- "variableType": "mdc_press_bld_nxband_dia",
- "variableName": "Presión diastólica (banda)"
}, - {
- "value": 67,
- "samplingDate": "2024-06-29T11:15:00.000Z",
- "variableType": "mdc_press_bld_nxband_dia",
- "variableName": "Presión diastólica (banda)"
}, - {
- "value": 37.2,
- "samplingDate": "2024-06-29T11:00:00.608Z",
- "variableType": "mdc_temp_body_nxband",
- "variableName": "Temperatura corporal (banda)"
}, - {
- "value": 98,
- "samplingDate": "2024-06-29T11:00:00.000Z",
- "variableType": "mdc_sp02_nxband",
- "variableName": "Saturación de oxígeno (banda)"
}
]
}
]
}
}