Organizations

6 endpoints in this category.

GET/organizations

Search Organizations

Search for organizations by name. Returns matching organizations with type and member count.

Authentication:Required — Authorization: Bearer <token>

Query Parameters

Name	Type	Required	Description
`search`	`string`	No	Search query

Response Fields

Name	Type	Required	Description
`data`	`Organization[]`	Yes	Array of matching organizations

Error Codes

Status	Meaning
`401`	Unauthorized

Code Examples

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

GET/my-organization

Get My Organization

Get details of the authenticated user's current organization.

Authentication:Required — Authorization: Bearer <token>

Response Fields

Name	Type	Required	Description
`data`	`Organization`	Yes	Organization details

Error Codes

Status	Meaning
`404`	User is not in an organization

Code Examples

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

POST/organizations/:uuid/join-request

Request to Join Organization

Submit a request to join an organization. The org admin must approve.

Authentication:Required — Authorization: Bearer <token>

Path Parameters

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

Error Codes

Status	Meaning
`404`	Organization not found
`409`	Already a member or pending request exists

Code Examples

curl -X POST 'https://visitnote-api-production.up.railway.app/api/therapist/v1/organizations/:uuid/join-request' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN'

POST/my-organization/leave

Leave Organization

Leave the current organization. Subscription status may change from org_managed to expired.

Authentication:Required — Authorization: Bearer <token>

Error Codes

Status	Meaning
`404`	Not in an organization

Code Examples

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

POST/organizations/request

Request New Organization

Request that a new organization be added to the platform.

Authentication:Required — Authorization: Bearer <token>

Request Body

Name	Type	Required	Description
`name`	`string`	Yes	Organization name
`type`	`string`	Yes	Organization type (staffing_company, home_health_agency, clinic, private_practice, hospital)
`email`	`string`	No	Contact email for the org

Error Codes

Status	Meaning
`422`	Invalid organization type

Code Examples

curl -X POST 'https://visitnote-api-production.up.railway.app/api/therapist/v1/organizations/request' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "name": "your_name",
  "type": "your_type",
  "email": "your_email"
}'

GET/my-join-requests

Get My Join Requests

List all pending join requests for the authenticated user.

Authentication:Required — Authorization: Bearer <token>

Response Fields

Name	Type	Required	Description
`data`	`JoinRequest[]`	Yes	Array of join requests

Error Codes

Status	Meaning
`401`	Unauthorized

Code Examples

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

Sign in to access API docs

Full API reference is available to VisitNote subscribers.

Don't have an account? Start free trial