v0 App

Overview

The MedCare API provides programmatic access to patient data, insurance verification, and claim submission functionality. All API requests require authentication and return JSON responses.

Authentication

Authorization Header

Bearer YOUR_API_KEY

Example Request

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.medcare.com/v1/patients

Endpoints

Patient Management

GET/api/v1/patients

Retrieve list of all patients

GET/api/v1/patients/:id

Get specific patient by ID

POST/api/v1/patients

Create new patient record

PUT/api/v1/patients/:id

Update existing patient record

Insurance Verification

POST/api/v1/insurance/verify

Initiate insurance verification via VAPI

GET/api/v1/insurance/coverage/:patientId

Get insurance coverage details for patient

GET/api/v1/insurance/transcript/:verificationId

Retrieve VAPI call transcript

Claim Submission

POST/api/v1/claims/submit

Submit new insurance claim

GET/api/v1/claims/:claimId

Get claim status and details

GET/api/v1/claims/patient/:patientId

Get all claims for specific patient

Care Timeline

GET/api/v1/timeline/:patientId

Get care timeline events for patient

POST/api/v1/timeline/event

Add new care event to timeline

GET/api/v1/timeline/codes/:eventId

Get mapped insurance codes for care event

Response Format

{
  "success": true,
  "data": {
    // Response data here
  },
  "message": "Operation completed successfully",
  "timestamp": "2024-01-15T10:30:00Z"
}

Error Handling

400

Bad Request - Invalid parameters

401

Unauthorized - Invalid or missing API key

404

Not Found - Resource does not exist

500

Internal Server Error - Contact support

Rate Limiting

API requests are limited to 1000 requests per hour per API key. Rate limit headers are included in all responses:

X-RateLimit-Limit: Maximum requests per hour
X-RateLimit-Remaining: Remaining requests in current window
X-RateLimit-Reset: Timestamp when rate limit resets

Support

For API support, integration assistance, or to request additional endpoints, please contact our developer support team at api-support@medcare.com

API Reference