# ShiftCare Care Connector

> A REST API over a ShiftCare user's data, for building dashboards and integrations.

## API
- OpenAPI spec: https://cnk2kqvtwr.ap-southeast-2.awsapprunner.com/openapi.json
- Base URL: https://cnk2kqvtwr.ap-southeast-2.awsapprunner.com/api/v1
- Auth: HTTP Bearer with an API key. Mint one via the create_dashboard_api_key MCP tool.
- Call server-side only; never expose the key in browser code.
- Data is scoped to the ShiftCare user the key is bound to.

## Endpoints
- GET /api/v1/clients
- GET /api/v1/clients/{clientId}
- GET /api/v1/clients/{clientId}/documents
- GET /api/v1/clients/{clientId}/care-plans
- GET /api/v1/care-plans/{id}?client_id={clientId}
- GET /api/v1/care-plans/{id}/goals?client_id={clientId}
- GET /api/v1/care-plans/{id}/tasks?client_id={clientId}
- GET /api/v1/care-plans/{id}/focus-areas?client_id={clientId}
- GET /api/v1/care-plans/{id}/reviews?client_id={clientId}
- GET /api/v1/clients/{clientId}/medical-history?type=conditions|procedures|allergies
- GET /api/v1/incidents
- GET /api/v1/shifts?start_date=YYYY-MM-DD&end_date=YYYY-MM-DD
- GET /api/v1/shifts/{id}
- GET /api/v1/forms
- GET /api/v1/forms/{id}/responses
- GET /api/v1/staff
- GET /api/v1/staff/compliance?account_id={id}&summary=true
- GET /api/v1/complaints
- GET /api/v1/invoices?period={DD/MM/YYYY - DD/MM/YYYY}
- GET /api/v1/quotes
- GET /api/v1/price-books?account_id={id}
- GET /api/v1/medications
- GET /api/v1/clients/{clientId}/funds?account_id={id}
- GET /api/v1/clients/{clientId}/fund-transactions?account_id={id}&start_date=&end_date=
- GET /api/v1/segments?account_id={id}
- GET /api/v1/leaves?account_id={id}
- GET /api/v1/leaves/metrics?account_id={id}
- GET /api/v1/dashboard/operations/{metric}?account_id={id}
- GET /api/v1/dashboard/user-tasks/{metric}?account_id={id}

## Building a dashboard
Fetch on load from a server/BFF that holds the API key, then render. Example:
  fetch("https://cnk2kqvtwr.ap-southeast-2.awsapprunner.com/api/v1/clients", { headers: { Authorization: "Bearer <API_KEY>" } })