Subscription

2 endpoints in this category.

GET/subscription/status

Get Subscription Status

Get the current subscription state for the authenticated user.

Authentication:Required — Authorization: Bearer <token>

Response Fields

Name	Type	Required	Description
`subscription_status`	`string`	Yes	trial \| active \| expired \| org_managed
`trial_ends_at`	`string\|null`	No	ISO 8601 trial end date
`expires_at`	`string\|null`	No	Subscription expiry date
`product_id`	`string\|null`	No	visitnote_monthly or visitnote_annual
`platform`	`string\|null`	No	apple or google

Error Codes

Status	Meaning
`401`	Unauthorized

Code Examples

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

POST/subscription/verify-receipt

Verify IAP Receipt

Submit an Apple App Store or Google Play receipt for server-side verification.

Authentication:Required — Authorization: Bearer <token>

Send transaction_id for Apple (iOS) or purchase_token for Google (Android). One of the two is required.

Request Body

Name	Type	Required	Description
`product_id`	`string`	Yes	visitnote_monthly or visitnote_annual
`platform`	`string`	Yes	'apple' or 'google'
`transaction_id`	`string`	No	Apple transaction ID (iOS only)
`purchase_token`	`string`	No	Google purchase token (Android only)

Error Codes

Status	Meaning
`422`	Invalid receipt or product_id
`409`	Receipt already processed

Code Examples

curl -X POST 'https://visitnote-api-production.up.railway.app/api/therapist/v1/subscription/verify-receipt' \
  -H 'Accept: application/json' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Content-Type: application/json' \
  -d '{
  "product_id": "your_product_id",
  "platform": "your_platform",
  "transaction_id": "your_transaction_id",
  "purchase_token": "your_purchase_token"
}'