Haplotypefrequencycu Haplotype Frequency Curation Service

Name: Haplotype Frequency Curation Service API
Brand: Haplotype Frequency Curation Service
Availability: InStock

★ Only Publicly Available OpenAPI DocumentHealthcareClinical Datanone10 EndpointsREST

For Agents

Install Jentic One Beta

Connect the Haplotype Frequency Curation Service to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Haplotype Frequency Curation Service, 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 | sh

Step 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 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 Haplotype Frequency Curation Service API.

Submit a new haplotype frequency curation via POST /hfc

List existing haplotype frequency submissions

Retrieve the haplotype list for a specific submission

GET STARTED

Start building with Haplotype Frequency Curation Service API

Explore with Jentic

View OpenAPI Document

The Haplotype Frequency Curation Service stores and returns curated haplotype frequency datasets used in HLA typing, transplant matching, and population genetics research. The API exposes 10 endpoints to submit a curation, list submissions, and read back haplotype, cohort, population, label, and scope metadata for any submission ID. A separate /hfc/population endpoint returns canonical population definitions used across submissions. The service is read-mostly and does not include transactional patient data.

Use Cases

Patterns agents use Haplotype Frequency Curation Service API for, with concrete tasks.

★ HLA Frequency Lookup for Transplant Matching

Pull curated haplotype frequencies for a specific donor population to inform HLA matching probability calculations. The API returns haplotypes, cohort, and population metadata for any submission ID, so research teams can reproduce or adjust matching models. Coverage depends on which submissions are loaded into the curation service.

Fetch haplotypes for submission ID 'sub-eu-2023' via GET /hfc/sub-eu-2023/haplotypes and summarise the top 10 frequencies.

Population Genetics Research Catalogue

Browse all curated submissions through GET /hfc and drill into each via GET /hfc/{submissionId} to assemble a research catalogue. Each submission carries cohort, population, label, and scope metadata that researchers use to filter and compare studies. The catalogue is read-only from the API perspective once curations are submitted.

List all submissions via GET /hfc and produce a table of submissionId, cohort size, and population label.

Submitting a New Haplotype Curation

Researchers contributing haplotype frequencies to the registry POST a structured payload to /hfc with cohort, population, scope, and the haplotype list. The service validates the payload and returns the assigned submission ID, which is then referenced by all downstream read endpoints. The submission step is the only write in the API.

Construct a POST /hfc body with cohort, population, scope, and haplotype list fields and submit it, returning the new submissionId.

AI Agent Bioinformatics Lookup

Wire a bioinformatics assistant that can answer 'what's the frequency of haplotype X in population Y' by calling /hfc/{submissionId}/haplotypes and /hfc/population through Jentic. The API has no authentication, so Jentic still mediates discovery and schema loading without any vault step. The agent cannot mutate existing submissions.

When asked 'what populations are in submission sub-2024-01', call GET /hfc/sub-2024-01/population and return the population label and size.

Key Endpoints

10 endpoints — the haplotype frequency curation service stores and returns curated haplotype frequency datasets used in hla typing, transplant matching, and population genetics research.

METHOD

PATH

DESCRIPTION

GET

/hfc

List all submissions

POST

/hfc

Submit a new haplotype frequency curation

GET

/hfc/{submissionId}

Get a single submission

GET

/hfc/{submissionId}/haplotypes

Get haplotypes for a submission

GET

/hfc/{submissionId}/cohort

Get cohort metadata

GET

/hfc/{submissionId}/population

Get population for a submission

GET

/hfc/population

List canonical population definitions

GET

/hfc

List all submissions

POST

/hfc

Submit a new haplotype frequency curation

GET

/hfc/{submissionId}

Get a single submission

GET

/hfc/{submissionId}/haplotypes

Get haplotypes for a submission

GET

/hfc/{submissionId}/cohort

Get cohort metadata

Why Jentic?

Three things that make agents converge on Jentic-routed access.

Credential isolation

The API has no securitySchemes, so no credentials need to be handled. Jentic still mediates the call so the agent receives only the operation result and never the raw connection details.

Intent-based discovery

Agents search Jentic for 'list haplotype frequency submissions' and Jentic returns GET /hfc with the schema, removing the need to find the SwaggerHub specification.

Time to first call

Direct integration: a few hours to model the 10 endpoints. Through Jentic: under 15 minutes.

FAQs

Specific to using Haplotype Frequency Curation Service API through Jentic.

What authentication does the Haplotype Frequency Curation Service use?

The OpenAPI spec defines no securitySchemes for this service, so it is open access at the API level. Operators may put it behind a network gateway or API gateway in production; check with the hosting institution before submitting curations. Jentic still mediates schema discovery even when no credentials are needed.

Can I submit a new haplotype curation via the API?

Yes. POST /hfc accepts a payload describing the cohort, population, scope, labels, and haplotype list, and returns the assigned submissionId. All read endpoints then take that submissionId as a path parameter.

What are the rate limits for this API?

Rate limits are not specified in the OpenAPI spec. As a research curation service, throughput is expected to be low (a few submissions per day per researcher, occasional read bursts). Operators may apply gateway-level throttling that is not surfaced in the spec.

How do I retrieve haplotypes for a submission through Jentic?

Search Jentic for 'get haplotypes for a submission', load the schema for GET /hfc/{submissionId}/haplotypes, and execute with the submissionId. Run pip install jentic and use the async client.search, client.load, and client.execute pattern.

Does this API store patient-level genetic data?

No. The service stores curated frequency datasets aggregated across cohorts, plus cohort and population metadata. It does not hold individual patient genotypes or PHI. Use a dedicated EHR or genomics platform for patient-level data.

Haplotypefrequencycu Haplotype Frequency Curation Service

Connect the Haplotype Frequency Curation Service to your agent

Capabilities

Start building with Haplotype Frequency Curation Service API

Use Cases

Key Endpoints

Why Jentic?

Related APIs

FAQs