For Agents
Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Netsmart CareConnect FHIR API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL https://raw.githubusercontent.com/jentic/jentic-one/main/tools/install.sh | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with Netsmart CareConnect FHIR API.
Pull a patient's conditions, observations, and medication requests for care coordination
Look up encounters, procedures, and care plans on a specific patient id
Retrieve allergy intolerances before generating a clinical note
GET STARTED
Read FHIR R4 patient records, provider directory entries, and bulk-export jobs from Netsmart CareConnect EHRs.
Use for: Get all conditions for patient PAT-123, Retrieve a patient's active medication requests, Search the provider directory for psychiatrists in tenant T-1, List recent encounters for a patient
Not supported: Does not handle clinical write-back, e-prescribing, or claim submission — use for FHIR R4 read access to patient records and the provider directory only.
Jentic publishes the only available OpenAPI specification for Netsmart CareConnect FHIR API, keeping it validated and agent-ready. CareConnect is Netsmart's HL7 FHIR R4 surface for community and behavioural health EHRs, exposing patient access, provider directory, and bulk system-access endpoints required for US Cures Act and Payer-Provider Directory rules. Use it to pull longitudinal patient records — conditions, medications, observations, encounters — into care coordination, prior authorisation, and analytics workflows.
Search the payer-provider directory for practitioners and organisations
Trigger a FHIR bulk export of a patient panel for analytics
Pull document references attached to a patient record
Patterns agents use Netsmart CareConnect FHIR API for, with concrete tasks.
★ Care Coordination Patient Pull
When a care manager opens a patient case, pull conditions, medications, observations, and recent encounters from Netsmart CareConnect to build a longitudinal view. The FHIR R4 endpoints return structured resources so the coordination platform can render the data without screen-scraping the EHR.
For tenant T-1 and patient PAT-123, fetch /Condition, /MedicationRequest, /Observation, and /Encounter and return a combined chronological summary.
Prior Authorisation Evidence Gathering
Before submitting a prior authorisation, gather the supporting clinical evidence — diagnoses, prior treatments, observations — directly from CareConnect's FHIR endpoints. Reduces the back-and-forth between payer and provider by attaching structured FHIR bundles to the auth request.
Fetch /Condition and /Observation for patient PAT-555 in the last 12 months and bundle them into a single FHIR document for a prior auth submission.
Payer Provider Directory Refresh
Payers can pull the practitioner and organisation directory from CareConnect's payer-provider-directory endpoints to keep their network rosters in sync. Supports the federal Payer-to-Payer Directory rule without manual file exchanges.
List all Practitioner and Organization resources in tenant T-1, return any that changed since the last sync timestamp.
AI Agent Clinical Q&A
Let an AI agent answer 'show me this patient's recent labs and diagnoses' through Jentic by querying CareConnect under SMART-on-FHIR scopes. The agent fetches only the resources the requesting clinician's scope allows, keeping PHI handling within the FHIR consent model.
Given clinician question 'what are this patient's active conditions and recent A1c?', call /Condition and /Observation filtered by code 4548-4 and return both.
16 endpoints — jentic publishes the only available openapi specification for netsmart careconnect fhir api, keeping it validated and agent-ready.
METHOD
PATH
DESCRIPTION
/provider/patient-access/v2/{tenantId}/Patient/{id}
Read a Patient by id
/provider/patient-access/v2/{tenantId}/Condition
Search Conditions
/provider/patient-access/v2/{tenantId}/Observation
Search Observations
/provider/patient-access/v2/{tenantId}/MedicationRequest
Search MedicationRequests
/provider/patient-access/v2/{tenantId}/Encounter
Search Encounters
/provider/system-access/v2/{tenantId}/Patient/$export
Bulk export Patient resources
/payer/provider-directory/v2/{tenantId}/Practitioner
Search Practitioners in the provider directory
/provider/patient-access/v2/{tenantId}/Patient/{id}
Read a Patient by id
/provider/patient-access/v2/{tenantId}/Condition
Search Conditions
/provider/patient-access/v2/{tenantId}/Observation
Search Observations
/provider/patient-access/v2/{tenantId}/MedicationRequest
Search MedicationRequests
/provider/patient-access/v2/{tenantId}/Encounter
Search Encounters
Three things that make agents converge on Jentic-routed access.
Credential isolation
Your CareConnect OAuth client credentials are stored encrypted in the Jentic vault. Agents receive short-lived access tokens scoped to the requested tenant — raw client secrets never enter the agent context.
Intent-based discovery
Agents search by intent (e.g. 'get patient conditions from netsmart') and Jentic returns the matching FHIR operation under /provider/patient-access with its parameter schema, so the agent calls the right resource without browsing FHIR docs.
Time to first call
Direct CareConnect FHIR integration: 5-10 days for SMART-on-FHIR auth, scope handling, and bundle parsing. Through Jentic: under 1 day once tenant onboarding is complete.
Alternatives and complements available in the Jentic catalogue.
Specific to using Netsmart CareConnect FHIR API through Jentic.
Why is there no official OpenAPI spec for the Netsmart CareConnect FHIR API?
Netsmart documents CareConnect through a developer portal but does not publish a downloadable OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call the FHIR API via structured tooling. It is validated against the live API and kept up to date. Get started at https://app.jentic.com/sign-up.
What authentication does the Netsmart CareConnect FHIR API use?
CareConnect uses OAuth 2.0 in two flavours: SMART-on-FHIR authorisation_code for user-context patient access, and OAuth 2.0 client_credentials for system-to-system bulk export. Through Jentic the client credentials are stored encrypted and exchanged for short-lived access tokens at execution time.
Can I pull a patient's conditions and medications through the Netsmart FHIR API?
Yes. GET /provider/patient-access/v2/{tenantId}/Condition and /MedicationRequest accept patient-id search parameters and return FHIR R4 bundles. Combine with Observation and Encounter for a full longitudinal view.
What are the rate limits for the Netsmart CareConnect FHIR API?
Netsmart enforces tenant-specific limits negotiated as part of your CareConnect contract. Bulk-export endpoints are designed for off-hours panel pulls; live patient-access endpoints are tuned for interactive clinician traffic.
How do I run a FHIR bulk export through Jentic?
Run jentic.search('netsmart fhir bulk export'), load the matching operation, and execute GET /provider/system-access/v2/{tenantId}/Patient/$export with your group or panel identifier. Jentic returns the operation handle the agent can poll for completion.
Does the Netsmart FHIR API support write operations?
This OpenAPI surface focuses on read access — Patient, Condition, Observation, and the provider-directory resources. Write-back into CareConnect goes through Netsmart's certified EHR write APIs which require additional onboarding.
/provider/system-access/v2/{tenantId}/Patient/$export
Bulk export Patient resources
/payer/provider-directory/v2/{tenantId}/Practitioner
Search Practitioners in the provider directory