Allele frequency search
Search HLA allele frequencies by allele, locus, country, region and population, etc.
View endpointAPI documentation
Introduction
The Allele Frequency Net Database (AFND) API provides an access to a comprehensive, freely available repository of immune gene frequencies across worldwide populations. Through this API, users can query allele, haplotype, and genotype frequency data, enabling seamless integration of AFND resources into analytical pipelines, applications, and research workflows. The API is designed to support efficient data retrieval while promoting data sharing and collaboration within the scientific community.
How to use the API
Select the type of information you want to retrieve, such as HLA allele frequencies.
Add an allele, country, region, population, or another available filter to the end of the endpoint to refine your search.
Use the API endpoint in your own application, script, or data analysis workflow to retrieve AFND data programmatically.
Available endpoints
Choose the type of information you want to retrieve.
Haplotype frequency search
Search HLA haplotype frequencies by allele, locus, country, region and population, etc.
View endpointRare alleles search
Search for rare HLA alleles available in the database.
View endpointAllele / gene frequency search
Search KIR allele and gene frequency information.
View endpointGenotype frequency search
Search KIR genotype frequency data.
View endpointAllele frequency search
Search MIC allele frequency data.
View endpointPolymorphism frequency search
Search Cytokine polymorphism frequency data.
View endpointHLA
Allele frequency search endpoint
GET
https://www.allelefrequencies.net/api/hla/allele-frequencies/search
To add search criteria, append a ? to the end of the endpoint and add a parameter from the table below. Use & to add additional parameters.
Search criteria
| Parameter | Description | Value(s) | Example |
|---|---|---|---|
| allele | Allele name | A*01:01 | allele=A*01:01 |
| locus | Locus name | {A, B, C, DPA1, DPB1, ...} | locus=A |
| country | Country | {Albania, Algeria, American Samoa, ...} | country=Albania |
| geographicalRegion | Geographical region | {Asia, Australia, Europe, ...} | geographicalRegion=Europe |
| ethnicity | Ethnicity | {Amerindian, Black, Caucasian, ...} | ethnicity=Amerindian |
| populationStandard | Population standard | {goldOnly, goldAndSilver} | populationStandard=goldOnly |
| showFrequencies | Show only positives or negatives frequencies | {positives, negatives} | showFrequencies=positives |
| dataset | Source of data | {Literature, Proceedings of IHWs, Unpublished} | dataset=Literature |
| typeStudy | Type of study | {Anthropology, Blood Donor, Bone Marrow Registry, ...} | typeStudy=Anthropology Study |
| sortBy | Sort by | {allele, alleleFrequencyDesc, population, populationFrequencyDesc} | sortBy=alleleFrequencyDesc |
Examples
Search populations with the A*01:01 allele:
https://www.allelefrequencies.net/api/hla/allele-frequencies/search?allele=A*01:01
Search populations with the B*07 allele in Europe:
https://www.allelefrequencies.net/api/hla/allele-frequencies/search?allele=B*07&geographicalRegion=Europe
Click the Run button to test the endpoint and view the returned data in the Demo response section.
You can copy any example, modify its parameters to create your own query, and use it as a starting point for integrating the API into your application, script, or data analysis workflow.
Demo response (Up to 50 records are displayed here for preview).
Run an example to display the API response.