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

Submit, list, and inspect curated haplotype frequency datasets for HLA and population genetics research.

Quickstart

Get started with Haplotype Frequency Curation Service in minutes using your preferred integration method.

# Add to your MCP client config (Claude Desktop, Cursor, Windsurf)
{
  "jentic": {
    "url": "https://api.jentic.com/mcp",
    "auth": "oauth"
  }
}

# Then ask your agent:
"list haplotype frequency submissions"

# → Jentic returns the GET /events tool with parameter schema, agent executes.

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

Fetch cohort, population, label, and scope metadata for a submission

GET STARTED

Start building with Haplotype Frequency Curation Service API

Explore with Jentic

View OpenAPI Document

Jentic publishes the only available OpenAPI document for Haplotype Frequency Curation Service, keeping it validated and agent-ready.

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

Related APIs

Alternatives and complements available in the Jentic catalogue.

Complementary

ClinicalTrials.gov

Pair haplotype frequency lookups with clinical trial cohort discovery.

Use ClinicalTrials.gov when an agent needs to find studies that recruit specific populations alongside their haplotype frequencies.

Complementary

EBI

Broader bioinformatics datasets (sequences, annotations) to enrich haplotype curations.

Use EBI for sequence-level lookups; haplotypefrequencycu for aggregated frequency data only.

Complementary

NCBI Datasets

Reference genomes and gene metadata for context on haplotype regions.

Use NCBI Datasets when an agent needs gene or genome reference data alongside HLA haplotype frequencies.

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.