Install Jentic One Beta

Connect the Ocean Health Platform API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Ocean Health Platform 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://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcognisantmd.com%2Fcognisantmd-ocean" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcognisantmd.com%2Fcognisantmd-ocean" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic 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.

Capabilities

What an agent can do with Ocean Health Platform API.

Authenticate with OAuth 2.0 client credentials at /svc/oauth2/token to receive a Bearer access token

Search the Ocean patient registry via GET /fhir/v1/Patient using FHIR search parameters

Retrieve a single patient's FHIR record with GET /fhir/v1/Patient/{patientId}

Create an electronic referral as a FHIR ServiceRequest via POST /fhir/v1/ServiceRequest

GET STARTED

Start building with Ocean Health Platform API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use Ocean Health Platform API for, with concrete tasks.

★ EMR-to-Specialist eReferral Workflow

Primary care EMRs use Ocean to dispatch electronic referrals to specialist clinics across a region. The agent collects intake data inside the EMR, calls POST /fhir/v1/ServiceRequest with a FHIR ServiceRequest payload, and stores the returned id for status tracking. Replaces fax-based or PDF-attachment referrals with structured, auditable, FHIR-shaped data.

Build a FHIR ServiceRequest with patient reference, requester, performer, and category, then POST it to /fhir/v1/ServiceRequest and return the new referral id

Patient Lookup for Triage

Triage and intake tools resolve a patient against the Ocean registry before opening a chart or sending a referral. The agent calls GET /fhir/v1/Patient with FHIR search parameters (family, given, birthdate, identifier) and disambiguates among the matches. Saves the clinician from re-entering demographics for patients already known to Ocean.

Call GET /fhir/v1/Patient?family=Smith&given=Alice&birthdate=1980-03-12 and return matches with patient id and identifiers

Referral Status Monitoring

Care coordinators monitor outstanding referrals to make sure none stall in transit. The agent loops over GET /fhir/v1/ServiceRequest filtered by status and creation date, surfaces any referral older than a defined SLA, and posts a triage list to a coordinator's queue. Catches lost referrals before patients fall through the gaps.

Call GET /fhir/v1/ServiceRequest?status=active&_lastUpdated=lt-7d and return any referrals older than 7 days that are still active

Multi-Site Clinic Directory

Health authorities publish lists of Ocean-enabled clinic sites so referring providers know who is reachable. The agent calls GET /api/v1/sites and renders an internal directory with clinic name, location, and supported referral types. Keeps the directory in sync with what Ocean actually advertises rather than a manually maintained spreadsheet.

Call GET /api/v1/sites and render the response as a CSV with site id, name, and address fields for the internal directory

Agent-Driven Ocean Workflows via Jentic

An AI agent connected to Jentic can run a complete Ocean intake flow - search the patient, create a ServiceRequest, monitor status - without ever holding the OAuth client secret. Jentic stores the client credentials in its vault, mints access tokens on demand, and exposes the operations through intent search so the agent can search, load, and execute in seconds.

Search Jentic for 'create Ocean referral', execute POST /fhir/v1/ServiceRequest with the assembled FHIR payload, and return the new referral id and status

Key Endpoints

6 endpoints — jentic publishes the only available openapi specification for ocean health platform api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/fhir/v1/Patient

Search patients in the Ocean registry

GET

/fhir/v1/Patient/{patientId}

Get a patient's FHIR record

POST

/fhir/v1/ServiceRequest

Create a referral as a FHIR ServiceRequest

GET

/fhir/v1/ServiceRequest

Search referrals

GET

/fhir/v1/ServiceRequest/{referralId}

Get a referral's FHIR record

GET

/api/v1/sites

List Ocean clinic sites

GET

/fhir/v1/Patient

Search patients in the Ocean registry

GET

/fhir/v1/Patient/{patientId}

Get a patient's FHIR record

POST

/fhir/v1/ServiceRequest

Create a referral as a FHIR ServiceRequest

GET

/fhir/v1/ServiceRequest

Search referrals

GET

/fhir/v1/ServiceRequest/{referralId}

Get a referral's FHIR record

GET

/api/v1/sites

List Ocean clinic sites

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the Ocean Health Platform API by hand means running the OAuth 2.0 client-credentials flow against /svc/oauth2/token, minting short-lived access tokens, targeting ocean.cognisantmd.com/svc, and refreshing them yourself. Through Jentic you install once, import the Ocean Health Platform API from the API Directory, store the client credentials once, and your agent calls it while Jentic handles the tokens.

Permission scoping

Ocean puts the resource id in the URL path (/fhir/v1/Patient/{patientId} and /fhir/v1/ServiceRequest/{referralId}), so a rule can pin your agent to one patient or referral. You choose the operations it may call, so creating a new referral is only in the allowed set if you add it, letting reads of a patient or the site directory stay separate.

Credential isolation

Your Ocean OAuth 2.0 client credentials are stored once, encrypted, by your own Jentic One instance, and Jentic mints short-lived access tokens at execution time. The client secret never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'create an Ocean referral' or 'search Ocean patients', and Jentic returns the matching FHIR operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using Ocean Health Platform API through Jentic.

Why is there no official OpenAPI spec for Ocean Health Platform API?

CognisantMD does not publish an OpenAPI specification - only HTML API docs. Jentic generates and maintains this spec so that AI agents and developers can call Ocean Health Platform API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the Ocean Health Platform API use?

Ocean uses OAuth 2.0 client credentials. Exchange your client_id and client_secret at https://ocean.cognisantmd.com/svc/oauth2/token for a Bearer access token, then send it as Authorization: Bearer {token}. Through Jentic the credentials are stored in the vault and tokens are minted on demand.

Can I create electronic referrals through the Ocean API?

Yes. POST /fhir/v1/ServiceRequest accepts a FHIR R4 ServiceRequest payload containing patient reference, requester, performer, and category. The endpoint returns the created ServiceRequest with its assigned id, which the agent can use to track status via /fhir/v1/ServiceRequest/{referralId}.

What are the rate limits for the Ocean Health Platform API?

CognisantMD does not publish a public rate limit. Treat the API as best-effort, back off on HTTP 429 responses, and avoid sustained high-volume polling. For status monitoring, query referrals on a schedule with _lastUpdated filters rather than polling individual ids.

How do I search patients through Jentic?

Search Jentic for 'search Ocean patients', load the GET /fhir/v1/Patient schema, and execute it with the FHIR search parameters (family, given, birthdate, identifier). Jentic mints an OAuth access token from the vaulted client credentials and returns the parsed FHIR Bundle.

Does the Ocean API expose lab results or clinical notes?

No. The current spec covers Patient, ServiceRequest, and a sites lookup only. For lab results, encounters, or clinical notes, integrate directly with the EMR's FHIR endpoint; Ocean focuses on the eReferral and patient engagement use cases.

Can I limit what my agent is allowed to do with the Ocean Health Platform API?

Yes. Jentic One is self-hosted, so you run it and your own rules decide which Ocean operations and credentials the agent may use. You choose the allowed set of operations, so reading patients with GET /fhir/v1/Patient or listing clinic sites with GET /api/v1/sites can be permitted while POST /fhir/v1/ServiceRequest to create a referral stays excluded unless you add it. Because Ocean puts the resource id in the path, a rule can also pin the agent to a single patient or referral via /fhir/v1/Patient/{patientId} or /fhir/v1/ServiceRequest/{referralId}.

Cognisantmd Ocean Health Platform API

AI ReadinessAI-Aware (A-)70/100

See full scorecard

Agent-ready OpenAPI document · curated by JenticHealthcareEhr Emroauth26 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Search and read Ocean patients, create and look up FHIR ServiceRequest referrals, and list clinic sites using OAuth 2.0 client credentials.

Use for: Search Ocean for a patient by name and date of birth, Retrieve a patient's FHIR record from Ocean, Create an electronic referral to a specialist clinic, Look up the status of a previously submitted Ocean referral

Not supported: Does not handle lab results, prescriptions, billing, or patient messaging - use for Ocean patient lookup, FHIR ServiceRequest referrals, and site directory only.

Jentic publishes the only available OpenAPI specification for Ocean Health Platform API, keeping it validated and agent-ready. Ocean by CognisantMD is a Canadian eReferral, eConsult, and patient engagement platform widely used by primary care, specialist clinics, and regional health authorities to coordinate care between providers. The API exposes 6 endpoints over ocean.cognisantmd.com/svc - a small FHIR R4 surface for Patient and ServiceRequest plus a /api/v1/sites lookup for clinic locations. Authentication is OAuth 2.0 client credentials, and the endpoints are designed for partner EMRs, intake portals, and triage tools that need to read patient context and create or look up referrals.

Jentic One on Github View OpenAPI Document

Show dimension breakdown

Foundational Compliance

Base layer of spec validity and structural soundness.

Grade: ASignals: 4

99%

Lint Results

Aggregated quality score from linter diagnostics, weighted by severity.

100%

Resolution Completeness

Percentage of `$ref` references that resolve successfully.

100%

Specification Validity

Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).

30%

Structural Integrity

Structural correctness score based on schema issues using logarithmic dampening.

Developer Experience & Jentic Compatibility

Clarity, completeness, and ingestion readiness for developers and tooling.

Grade: B-Signals: 4

Example Density

How richly the API is illustrated with examples.

100%

Example Validity

Percentage of examples that conform to their schemas.

50%

Response Coverage

Percentage of operations with complete response definitions (success, client error, server error).

100%

Tooling Readiness

Health of API ingestion, bundling, and resolution within Jentic pipelines.

AI-Readiness & Agent Experience

Semantic breadth, depth, and agent comprehension for AI systems.

Grade: D+Signals: 4

41%

Description Coverage

Coverage of descriptions across API elements.

Error Standardization

Coverage of RFC 9457 Problem Details for error responses.

100%

OperationId Quality

Coverage, uniqueness, and casing consistency of operationIds for AI inference.

55%

Summary Coverage

Coverage of summaries across operations/tags/info.

Agent Usability

Functional utility, complexity comfort, and AI orchestration readiness.

Grade: A+Signals: 1

94%

Complexity Comfort

Agent comfort level based on API operational and structural complexity.

Security

Trust, risk posture, and security compliance.

Grade: ASignals: 1

85%

Authentication Strength

Average quality of security schemes based on authentication method strength (weakest link for OAuth2).

100

AI Discoverability

Findability, semantic richness, and reasoning readiness.

Grade: A+Signals: 1

100%

Descriptive Richness

Clarity and depth of descriptions across API elements.

Connect the Ocean Health Platform API to your agent

Capabilities

Start building with Ocean Health Platform API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs

Cognisantmd Ocean Health Platform API

Jentic AI Readiness Score

Ocean Health Platform API

Foundational Compliance

Lint Results

Resolution Completeness

Specification Validity

Structural Integrity

Developer Experience & Jentic Compatibility

Example Density

Example Validity

Response Coverage

Tooling Readiness

AI-Readiness & Agent Experience

Description Coverage

Error Standardization

OperationId Quality

Summary Coverage

Agent Usability

Complexity Comfort

Security

Authentication Strength

AI Discoverability

Descriptive Richness