v51

latestOpenAPI 3.0.1GPL v3raw.githubusercontent.com2026-08-01367309794.4 KB
External Visits Controller

Get person information

Get some personal data for a specific person

get/visits-external/person/{personUuid}

Path parameters

personUuidstring required

Response

A selection of personal data, including first and last name, e-mail, phone number and birth date if available for that person. Regarding the e-mail and phone number: in SORMAS it is possible to store several e-mail addresses and phone numbers for a person. It is tried to provide one e-mail address and/or phone number via the external visits API in any feasible way.<br>if there is just one e-mail and/or phone number for a person, this is transmitted.<br>If there are several e-mail addresses and or phone numbers, SORMAS will transmit the ones marked as primary.<br>If there are several e-mail addresses or phone numbers without any marked as primary, SORMAS will request the user to mark one before registration.<br>Regarding the latestFollowUpEndDate: this is the latest follow up end date of any contact (or case, if the case follow up feature is enabled) related to the person. The contacts (and cases) considered are not filtered by disease.<br>Note that Null value fields may not be returned. If you get an unexpected result, it might help to verify if the personUuid is existing in your system via the isValid controller.<br>If you get "pseudonymized": true, the user the request was authorized with probably lacks the user role REST_EXTERNAL_VISITS_USER.