---
updatedAt: 2025-05-20T21:49:33.000Z
agentTools:
  projectIndex: https://developers.optt.health/llms.txt
---

# Retrieve a client in the institute

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "1.0.0",
    "title": "Profile APIs",
    "license": {
      "name": "Apache 2.0",
      "url": "http://www.apache.org/licenses/LICENSE-2.0.html"
    }
  },
  "tags": [
    {
      "name": "institute-client-controller",
      "description": "Institute Client Controller"
    }
  ],
  "paths": {
    "/institute/client/{clientId}": {
      "get": {
        "tags": [
          "institute-client-controller"
        ],
        "summary": "Retrieve a client in the institute",
        "operationId": "getClientUsingGET_2",
        "parameters": [
          {
            "name": "Authorization",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string",
              "default": "bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJleHAiOjE1OTk5MjYyNTgsInVzZXJfbmFtZSI6Imluc3RpdHV0ZSIsImF1dGhvcml0aWVzIjpbIklOU1RJVFVURSJdLCJqdGkiOiIyZDMzNGY5YS01OWFmLTRjMzctOWE0OS1iMGU4NzBhNTQzZjQiLCJjbGllbnRfaWQiOiJvcHR0LTAyZWU3N2RjLWFjNDUtNDM0NC04MTdlLTE3Y2E1MmI1OGI1ZCIsInNjb3BlIjpbInJlYWQiLCJ3cml0ZSJdfQ.ANh2KLL4IfolkPfaJ3JsUYQTFkpKxlXT5vCKzkwhvJsqUO5eBSErYB5H6c2kQvB3EWfLlFZAo1QQAgbHpkUm776qijWcncv77uT-drBvscInvBu0ahQh96Fdn9eXnbXrCBgt80RsZKkFI4W7SrziiVpXlFuUjKL4Jm5CkuK5dmAB6nPXJGnKx0qqg0uHfuHsHvJxfeoiqwz481oJ48dUx8W-CVDDAo79twFfqCmAm_yy8kgJe67_nGYfWPu6wY9Z5YCDnLiVM6Ky8md-hcQhScTIRAHql7nebfUIPb8h_J7jQbhAg2IwVLp92Xccp_F9gmeOu4O6dWy08Amstt1l2A"
            }
          },
          {
            "name": "offset",
            "in": "header",
            "description": "offset",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          },
          {
            "name": "clientId",
            "in": "path",
            "description": "clientId",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "*/*": {
                "schema": {
                  "$ref": "#/components/schemas/ClientResponseModel"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "//gwi.dv.optt.ca/gateway/profile/"
    }
  ],
  "components": {
    "schemas": {
      "CaregiverPartialResponseModel": {
        "type": "object",
        "properties": {
          "activationStatus": {
            "type": "string",
            "enum": [
              "ACTIVE",
              "INACTIVE",
              "PENDING",
              "VERIFIED",
              "INVITED"
            ]
          },
          "clinicId": {
            "type": "integer",
            "format": "int64"
          },
          "createDate": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "image": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "opttId": {
            "type": "string"
          },
          "position": {
            "type": "string"
          },
          "userId": {
            "type": "string"
          }
        },
        "title": "CaregiverPartialResponseModel"
      },
      "ClientPartialResponseModel": {
        "type": "object",
        "properties": {
          "activationStatus": {
            "type": "string",
            "enum": [
              "ACTIVE",
              "INACTIVE",
              "PENDING",
              "VERIFIED",
              "INVITED"
            ]
          },
          "chatId": {
            "type": "string"
          },
          "clinic": {
            "$ref": "#/components/schemas/ClinicResponseModel"
          },
          "clinicId": {
            "type": "integer",
            "format": "int64"
          },
          "clinicName": {
            "type": "string"
          },
          "createDate": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "image": {
            "type": "string"
          },
          "lastSession": {
            "$ref": "#/components/schemas/SessionPartialResponseModel"
          },
          "lastSessionNote": {
            "$ref": "#/components/schemas/NoteResponseModel"
          },
          "name": {
            "type": "string"
          },
          "opttId": {
            "type": "string"
          },
          "patientId": {
            "type": "string"
          },
          "userId": {
            "type": "string"
          }
        },
        "title": "ClientPartialResponseModel"
      },
      "ClientResponseModel": {
        "type": "object",
        "properties": {
          "activationDate": {
            "type": "string"
          },
          "activationStatusColor": {
            "type": "string",
            "enum": [
              "NONE",
              "GREEN",
              "RED"
            ]
          },
          "age": {
            "type": "integer",
            "format": "int32"
          },
          "birthDate": {
            "type": "string"
          },
          "birthYear": {
            "type": "integer",
            "format": "int32"
          },
          "caregiverChatId": {
            "type": "string"
          },
          "caregiverList": {
            "type": "array",
            "items": {
              "type": "integer",
              "format": "int64"
            }
          },
          "caregiverLovList": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CaregiverPartialResponseModel"
            }
          },
          "clientEmail": {
            "type": "string"
          },
          "clinic": {
            "$ref": "#/components/schemas/ClinicResponseModel"
          },
          "clinicId": {
            "type": "integer",
            "format": "int64"
          },
          "clinicName": {
            "type": "string"
          },
          "createDate": {
            "type": "string"
          },
          "email": {
            "type": "string"
          },
          "ethnicity": {
            "type": "string"
          },
          "externalClientId": {
            "type": "string"
          },
          "fromCpm": {
            "type": "boolean"
          },
          "gender": {
            "type": "string",
            "enum": [
              "MALE",
              "FEMALE",
              "TRANS_WOMAN",
              "TRANS_MAN",
              "TWO_SPIRIT",
              "GENDER_QUEER",
              "GENDER_FLUID",
              "ANDROGYNOUS",
              "NON_BINRAY",
              "OTHER"
            ]
          },
          "height": {
            "type": "number",
            "format": "float"
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "image": {
            "type": "string"
          },
          "invitationToken": {
            "type": "string"
          },
          "language": {
            "type": "string",
            "enum": [
              "EN",
              "FR"
            ]
          },
          "maritalStatus": {
            "type": "string"
          },
          "mobile": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "opttId": {
            "type": "string"
          },
          "patientId": {
            "type": "string"
          },
          "paymentStatus": {
            "type": "string"
          },
          "session": {
            "$ref": "#/components/schemas/SessionPartialResponseModel"
          },
          "status": {
            "type": "string",
            "enum": [
              "ACTIVE",
              "INACTIVE",
              "PENDING",
              "VERIFIED",
              "INVITED"
            ]
          },
          "userId": {
            "type": "string"
          },
          "weight": {
            "type": "number",
            "format": "float"
          }
        },
        "title": "ClientResponseModel"
      },
      "ClinicResponseModel": {
        "type": "object",
        "properties": {
          "activationStatus": {
            "type": "string",
            "enum": [
              "ACTIVE",
              "INACTIVE",
              "PENDING",
              "VERIFIED",
              "INVITED"
            ]
          },
          "address": {
            "type": "string"
          },
          "adminOpttId": {
            "type": "string"
          },
          "adminUserId": {
            "type": "string"
          },
          "allowCo": {
            "type": "boolean"
          },
          "baseUrl": {
            "type": "string"
          },
          "contactPersonName": {
            "type": "string"
          },
          "cpmLink": {
            "type": "string"
          },
          "createDate": {
            "type": "string"
          },
          "domainId": {
            "type": "integer",
            "format": "int64"
          },
          "email": {
            "type": "string"
          },
          "healthCardRequired": {
            "type": "boolean"
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "image": {
            "type": "string"
          },
          "invitationToken": {
            "type": "string"
          },
          "language": {
            "type": "string",
            "enum": [
              "EN",
              "FR"
            ]
          },
          "name": {
            "type": "string"
          },
          "phoneNumber": {
            "type": "string"
          },
          "termConditionLink": {
            "type": "string"
          }
        },
        "title": "ClinicResponseModel"
      },
      "NoteResponseModel": {
        "type": "object",
        "properties": {
          "caregiverId": {
            "type": "integer",
            "format": "int64"
          },
          "caregiverImage": {
            "type": "string"
          },
          "caregiverName": {
            "type": "string"
          },
          "content": {
            "type": "string"
          },
          "date": {
            "type": "string"
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "isAutoSave": {
            "type": "boolean"
          },
          "sessionId": {
            "type": "integer",
            "format": "int64"
          }
        },
        "title": "NoteResponseModel"
      },
      "SessionPartialResponseModel": {
        "type": "object",
        "properties": {
          "caregiver": {
            "$ref": "#/components/schemas/CaregiverPartialResponseModel"
          },
          "client": {
            "$ref": "#/components/schemas/ClientPartialResponseModel"
          },
          "createDate": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "id": {
            "type": "integer",
            "format": "int64"
          },
          "name": {
            "type": "string"
          },
          "sessionChatId": {
            "type": "string"
          },
          "sessionNote": {
            "type": "string"
          },
          "startDate": {
            "type": "string"
          }
        },
        "title": "SessionPartialResponseModel"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```