Cura API Reference

Base URL

All API requests should be made to:

https://api.mycura.org/api/cura

The base API URL is https://api.mycura.org.

Authentication

All API endpoints require authentication using an API key. Include your API key in the request headers:

X-API-Key: YOUR_API_KEY

Or as a query parameter:

?api_key=YOUR_API_KEY

Learn more about authentication.

Response Format

All API responses follow a consistent format:

Success Response

{
  "success": true,
  "response": "AI generated response text",
  "patient": { /* patient object when applicable */ }
}

Error Response

{
  "success": false,
  "error": "Error message describing what went wrong"
}

Available Endpoints

POST /chat

Generate AI responses with patient context and conversation history

GET /patients/{id}

Retrieve patient information by ID

POST /patients

Create a new patient record with health information

OpenAPI Specification

Access the complete OpenAPI specification at:

https://api.mycura.org/api/cura/openapi.json

Download OpenAPI Spec

Import into Postman, Insomnia, or generate client libraries

Error Codes

Status Code	Description
200	Success - Request completed successfully
201	Created - Resource created successfully (patient creation)
400	Bad Request - Invalid or missing required parameters
401	Unauthorized - Invalid or missing API key
404	Not Found - Resource doesn’t exist
409	Conflict - Duplicate resource (e.g., patient with same phone)
500	Internal Server Error - An unexpected error occurred

Overview

Conversation Threads

Chat & Messaging

Patient Management

Base URL

Authentication

Response Format

Success Response

Error Response

Available Endpoints

POST /chat

GET /patients/{id}

POST /patients

OpenAPI Specification

Download OpenAPI Spec

Error Codes

​Base URL

​Authentication

​Response Format

​Success Response

​Error Response

​Available Endpoints

POST /chat

GET /patients/{id}

POST /patients

​OpenAPI Specification

Download OpenAPI Spec

​Error Codes

Base URL

Authentication

Response Format

Success Response

Error Response

Available Endpoints

OpenAPI Specification

Error Codes