GET /patients/{id}

Endpoint

GET https://api.mycura.org/api/cura/patients/{id}

Path Parameters

string

required

The unique UUID of the patient to retrieve

Response

boolean

Indicates if the request was successful

object

The patient information object

Show Patient Object Fields

string

Unique patient identifier (UUID)

string

Patient’s full name

string

Patient’s phone number (normalized format)

string

Patient’s gender (may be null)

number

Patient’s age (may be null)

string

Patient’s height (may be null)

string

Patient’s weight (may be null)

string

Patient’s race/ethnicity (may be null)

string

Patient’s blood type (may be null)

array

Array of medical conditions

array

Array of current medications (may be null)

string

Known allergies (may be null)

array

Additional notes about the patient

boolean

Whether reminders are enabled

object

Prescription refill information (may be null)

string

How the patient joined (WEB, WHATSAPP, API, etc.) (may be null)

string

Patient’s subscription plan (default: “free”)

boolean

Whether WhatsApp terms were accepted

boolean

Whether to show audio prompt

string

Patient access code (may be null)

string

Apple Messages identifier (may be null)

boolean

Whether Apple Messages terms were accepted

string

Timestamp when patient record was created

string

Timestamp when patient record was last updated

string

Error message if the request failed (only present when success is false)

Examples

Basic Request

curl -X GET "https://api.mycura.org/api/cura/patients/28dffdd1-c18b-46e4-88f7-9b2f073c70dc" \
  -H "X-API-Key: YOUR_API_KEY"

const response = await fetch('https://api.mycura.org/api/cura/patients/28dffdd1-c18b-46e4-88f7-9b2f073c70dc', {
  method: 'GET',
  headers: {
    'X-API-Key': 'YOUR_API_KEY'
  }
});

const data = await response.json();
console.log(data.patient);

import requests

response = requests.get(
    'https://api.mycura.org/api/cura/patients/28dffdd1-c18b-46e4-88f7-9b2f073c70dc',
    headers={
        'X-API-Key': 'YOUR_API_KEY'
    }
)

data = response.json()
print(data['patient'])

Response Examples

Success Response

{
  "success": true,
  "patient": {
    "id": "28dffdd1-c18b-46e4-88f7-9b2f073c70dc",
    "name": "Ansh Mehta",
    "phone_number": "15622853979",
    "conditions": [
      "{\"name\":\"GERD\",\"symptoms\":\"Heart burn\"}"
    ],
    "allergies": null,
    "medications": null,
    "notes": [],
    "reminders_enabled": false,
    "refill_info": null,
    "join_status": null,
    "subscription_plan": "free",
    "whatsapp_terms_accepted": true,
    "created_at": "2025-08-29T22:08:42.746701+00:00",
    "updated_at": "2025-08-29T22:10:07.30223+00:00"
  }
}

Patient Not Found

{
  "error": "Patient not found"
}

Use Cases

Patient Lookup

Retrieve patient information before making chat requests to understand available context:

// Get patient info first
const response = await fetch(`https://api.mycura.org/api/cura/patients/${patientId}`, {
  headers: { 'X-API-Key': apiKey }
});
const { patient } = await response.json();

// Use patient context in chat
const chatResponse = await fetch('https://api.mycura.org/api/cura/chat', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'X-API-Key': apiKey
  },
  body: JSON.stringify({
    message: 'What are my medication interactions?',
    patientId: patient.id
  })
});

Data Synchronization

Sync patient data between your system and Cura:

// Check if patient data needs updating
const curaResponse = await fetch(`https://api.mycura.org/api/cura/patients/${patientId}`, {
  headers: { 'X-API-Key': apiKey }
});
const { patient: curaPatient } = await curaResponse.json();

const localPatient = await getLocalPatient(patientId);

if (curaPatient.updated_at !== localPatient.updated_at) {
  // Sync the data
  await updateLocalPatient(patientId, curaPatient);
}

Access Verification

Verify patient access before displaying sensitive information:

try {
  const response = await fetch(`https://api.mycura.org/api/cura/patients/${patientId}`, {
    headers: { 'X-API-Key': apiKey }
  });
  
  if (!response.ok) {
    throw new Error('Patient not found');
  }
  
  const { patient } = await response.json();
  // Patient exists and user has access
  displayPatientDashboard(patient);
} catch (error) {
  // Handle unauthorized access or missing patient
  showAccessDenied();
}

Best Practices

Privacy Considerations: Only retrieve patient data when necessary and ensure proper access controls are in place in your application.

Cache Appropriately: Cache patient data to reduce API calls, but refresh when needed
Error Handling: Always check for patient existence before using the data
Access Control: Implement proper authorization in your application layer
Data Freshness: Check updated_at timestamps to determine if cached data is stale

Error Codes

Status Code	Error Message	Description
401	”Unauthorized - Invalid API key”	The provided API key is invalid
404	”Patient not found”	No patient exists with the specified ID
500	”Failed to fetch patient”	An unexpected error occurred

Overview

Conversation Threads

Chat & Messaging

Patient Management

Endpoint

Path Parameters

Response

Examples

Basic Request

Response Examples

Success Response

Patient Not Found

Use Cases

Best Practices

Error Codes

​Endpoint

​Path Parameters

​Response

​Examples

​Basic Request

​Response Examples

​Success Response

​Patient Not Found

​Use Cases

​Best Practices

​Error Codes

Endpoint

Path Parameters

Response

Examples

Basic Request

Response Examples

Success Response

Patient Not Found

Use Cases

Best Practices

Error Codes