Marina Health API

The Marina Health REST API gives you programmatic access to AI-powered medical tools: summarisation, transcription, translation, data extraction, PDF report generation, and structured patient intake interviews.

Base URL

https://api.marinahealth.eu

Authentication

Most endpoints require a Bearer token. Obtain one by calling POST /auth/login. Tokens expire after 15 minutes — use POST /auth/refresh to get a new one.

Authorization Header

Authorization: Bearer eyJhbGciOiJIUzI1NiJ9...

Content Type

All JSON request bodies must include Content-Type: application/json. The Transcribe endpoint uses multipart/form-data.

Error Responses

All errors return a JSON body with a message field.

Error Response

{
  "message": "Email not verified"
}

Rate Limits

The Transcribe endpoint is rate-limited to 50 requests per hour per user. Other endpoints are subject to fair-use limits. When a rate limit is exceeded, the API returns 429 Too Many Requests.

Email Verification

All AI endpoints require a verified email address. If your email is not yet verified, these endpoints return 403 Forbidden. Call POST /auth/verify-email/resend to receive a new verification link.