Patients

7 endpoints in this category.

GET/patient/my-patients

Get My Patients

Get the list of patients assigned to the authenticated clinician with search and pagination.

Authentication:Required — Authorization: Bearer <token>

Query Parameters

Name	Type	Required	Description
`per_page`	`integer`	No	Results per page
`page`	`integer`	No	Page number
`search_by_name`	`string`	No	Search by patient name

Response Fields

Name	Type	Required	Description
`data`	`Patient[]`	Yes	Array of patients
`meta.last_page`	`integer`	Yes	Total number of pages

Error Codes

Status	Meaning
`401`	Unauthorized

Code Examples

curl -X GET 'https://visitnote-api-production.up.railway.app/api/therapist/v1/patient/my-patients' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN'

GET/patient/chart-details/:referralUuid

Get Chart Details

Get detailed chart information for a patient referral.

Authentication:Required — Authorization: Bearer <token>

Path Parameters

Name	Type	Required	Description
`referralUuid`	`string`	Yes	Patient referral UUID

Response Fields

Name	Type	Required	Description
`data`	`ChartDetail`	Yes	Chart detail object

Error Codes

Status	Meaning
`404`	Referral not found

Code Examples

curl -X GET 'https://visitnote-api-production.up.railway.app/api/therapist/v1/patient/chart-details/:referralUuid' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN'

GET/patient/general-summaryComing Soon

Get Patient Summary

Get a general summary of patient data with optional date range filtering.

Authentication:Required — Authorization: Bearer <token>

Query Parameters

Name	Type	Required	Description
`dateRange`	`string`	No	Date range filter

Response Fields

Name	Type	Required	Description
`data`	`object`	Yes	Summary data

Error Codes

Status	Meaning
`401`	Unauthorized

Code Examples

curl -X GET 'https://visitnote-api-production.up.railway.app/api/therapist/v1/patient/general-summary' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN'

POST/patient/get-scheduled-visits/:referralUuidComing Soon

Get Patient Scheduled Visits

Get scheduled visits for a specific patient referral, filterable by month and year.

Authentication:Required — Authorization: Bearer <token>

Path Parameters

Name	Type	Required	Description
`referralUuid`	`string`	Yes	Patient referral UUID

Request Body

Name	Type	Required	Description
`filter_month`	`string`	No	Month filter (01-12)
`filter_year`	`string`	No	Year filter (YYYY)

Response Fields

Name	Type	Required	Description
`data`	`ScheduledVisit[]`	Yes	Array of scheduled visits

Error Codes

Status	Meaning
`404`	Referral not found

Code Examples

curl -X POST 'https://visitnote-api-production.up.railway.app/api/therapist/v1/patient/get-scheduled-visits/:referralUuid' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "filter_month": "your_filter_month",
  "filter_year": "your_filter_year"
}'

POST/patient/create

Create Patient

Create a new patient record.

Authentication:Required — Authorization: Bearer <token>

Request Body

Name	Type	Required	Description
`first_name`	`string`	Yes	Patient first name
`last_name`	`string`	Yes	Patient last name
`email`	`string`	No	Email address
`phone`	`string`	No	Phone number
`address`	`string`	No	Address

Response Fields

Name	Type	Required	Description
`uuid`	`string`	Yes	Created patient UUID

Error Codes

Status	Meaning
`422`	Validation error

Code Examples

curl -X POST 'https://visitnote-api-production.up.railway.app/api/therapist/v1/patient/create' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "first_name": "your_first_name",
  "last_name": "your_last_name",
  "email": "your_email",
  "phone": "your_phone",
  "address": "your_address"
}'

PUT/patient/update/:uuid

Update Patient

Update an existing patient's information.

Authentication:Required — Authorization: Bearer <token>

Path Parameters

Name	Type	Required	Description
`uuid`	`string`	Yes	Patient UUID

Request Body

Name	Type	Required	Description
`first_name`	`string`	No	Patient first name
`last_name`	`string`	No	Patient last name
`email`	`string`	No	Email address
`phone`	`string`	No	Phone number
`address`	`string`	No	Address

Error Codes

Status	Meaning
`404`	Patient not found
`422`	Validation error

Code Examples

curl -X PUT 'https://visitnote-api-production.up.railway.app/api/therapist/v1/patient/update/:uuid' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "first_name": "your_first_name",
  "last_name": "your_last_name",
  "email": "your_email",
  "phone": "your_phone",
  "address": "your_address"
}'

GET/document/listComing Soon

Get Documents

Get the list of documents for the authenticated clinician.

Authentication:Required — Authorization: Bearer <token>

Response Fields

Name	Type	Required	Description
`data`	`Document[]`	Yes	Array of documents

Error Codes

Status	Meaning
`401`	Unauthorized

Code Examples

curl -X GET 'https://visitnote-api-production.up.railway.app/api/therapist/v1/document/list' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN'