Skip to main content
GET
/
clients
/
{id}
curl -X 'GET' \
  'http://localhost:5001/clients/1e438c64-f0de-41c1-8ab4-d4c5e6f17d21' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer <your_access_token>'

{
  "user_id": "1e438c64-f0de-41c1-8ab4-d4c5e6f17d21",
  "firstName": "Jaime",
  "lastName": "Reyes",
  "dateOfBirth": "1992-01-01T00:00:00.000Z",
  "sex": "male",
  "phone": "5556667777",
  "email": "8blue.beetle@reachtech.org",
  "address1": null,
  "address2": null,
  "cityId": null,
  "stateId": null,
  "countryId": null,
  "postal": null,
  "timezone": null,
  "locale": null,
  "metadata": null,
  "createdAt": "2025-12-01T05:28:37.633Z",
  "updatedAt": "2025-12-01T05:29:17.866Z",
  "notes": null,
  "emergencyContact": null,
  "emergencyContactCode": null,
  "emergencyContactName": null,
  "employer": null,
  "workMobile": null,
  "gfeStateId": null,
  "profileImageBlobPath": null,
  "maritalStatus": null,
  "isHomeAddressSameAsShipping": true,
  "vouchedJobId": null,
  "isVerified": "NOTVERIFIED",
  "vouchedInviteSentDate": null,
  "vouchedReminderCount": 0,
  "vouchedResultMessage": null,
  "vouchedResponsePayload": null,
  "acsUserId": null,
  "state": null,
  "adminUser": {
    "id": "1e438c64-f0de-41c1-8ab4-d4c5e6f17d21",
    "email": "8blue.beetle@reachtech.org",
    "phone": "5556667777",
    "countryCode": "+1",
    "otpExpiresAt": null,
    "name": "Jaime Reyes",
    "isActive": true,
    "isTemporaryPassword": true,
    "lastPasswordReset": null,
    "createdAt": "2025-12-01T05:28:37.628Z"
  }
}

​
Overview

Retrieve the full details for a specific patient using their unique UUID. This returns the patient record along with the linked admin user object.

​
Headers

This endpoint uses Machine-to-Machine (M2M) authentication.
​
Authorization
string
required
Standard Bearer token (e.g., Bearer <your_access_token>). See the M2M Authentication guide for details.
​
accept
string
Optional. Accept header to specify response media type, e.g., application/json.

​
Path Parameters

​
id
string
required
The unique UUID of the patient to retrieve.

​
Response Parameters

The response returns the complete patient object and nested adminUser details.
​
user_id
string
The unique UUID assigned to the patient.
​
firstName
string
Patient First Name.
​
lastName
string
Patient Last Name.
​
dateOfBirth
string
ISO 8601 date of birth.
​
sex
string
Patient gender/sex.
​
phone
string
Patient phone number.
​
email
string
Patient email address.
​
address1
string
Primary address line 1.
​
postal
string
Postal or ZIP code.
​
metadata
object
Additional dynamic metadata.
​
isVerified
string
Verification status (e.g., "NOTVERIFIED", "VERIFIED").
​
createdAt
string
Creation timestamp (ISO 8601).
​
updatedAt
string
Last updated timestamp (ISO 8601).
​
adminUser
object
Nested object with admin user information associated with this patient.

​
Status Codes

StatusDescription
200OK. Patient details retrieved successfully.
401Unauthorized. Invalid or missing authentication token.
404Not Found. No patient exists with the specified id.
curl -X 'GET' \
  'http://localhost:5001/clients/1e438c64-f0de-41c1-8ab4-d4c5e6f17d21' \
  -H 'accept: */*' \
  -H 'Authorization: Bearer <your_access_token>'

{
  "user_id": "1e438c64-f0de-41c1-8ab4-d4c5e6f17d21",
  "firstName": "Jaime",
  "lastName": "Reyes",
  "dateOfBirth": "1992-01-01T00:00:00.000Z",
  "sex": "male",
  "phone": "5556667777",
  "email": "8blue.beetle@reachtech.org",
  "address1": null,
  "address2": null,
  "cityId": null,
  "stateId": null,
  "countryId": null,
  "postal": null,
  "timezone": null,
  "locale": null,
  "metadata": null,
  "createdAt": "2025-12-01T05:28:37.633Z",
  "updatedAt": "2025-12-01T05:29:17.866Z",
  "notes": null,
  "emergencyContact": null,
  "emergencyContactCode": null,
  "emergencyContactName": null,
  "employer": null,
  "workMobile": null,
  "gfeStateId": null,
  "profileImageBlobPath": null,
  "maritalStatus": null,
  "isHomeAddressSameAsShipping": true,
  "vouchedJobId": null,
  "isVerified": "NOTVERIFIED",
  "vouchedInviteSentDate": null,
  "vouchedReminderCount": 0,
  "vouchedResultMessage": null,
  "vouchedResponsePayload": null,
  "acsUserId": null,
  "state": null,
  "adminUser": {
    "id": "1e438c64-f0de-41c1-8ab4-d4c5e6f17d21",
    "email": "8blue.beetle@reachtech.org",
    "phone": "5556667777",
    "countryCode": "+1",
    "otpExpiresAt": null,
    "name": "Jaime Reyes",
    "isActive": true,
    "isTemporaryPassword": true,
    "lastPasswordReset": null,
    "createdAt": "2025-12-01T05:28:37.628Z"
  }
}