Allele Query Help Page

The IPD-IMGT/HLA and IPD-KIR Database allows you to retrieve information about a specific HLA or KIR alleles as named in the WHO Nomenclature Committee Reports. The Allele Query API has two entry points. This page documents the web based user interface. For information about the REST API please see our REST API help page. For information regarding what fields are available to be queried and their description please see our HLA Allele list Fields or KIR Allele list Fields pages.

The Allele Query tool provides a web based user interface for building custom queries to the IPD-IMGT/HLA Database. It has the following query options:

  • Allele Name Query - Quickly query IPD accessions, allele names, aliases and previous noemnclature
  • Advanced Query - Construct custom queries for all fields in the database
  • Field Select - Select specific fields to incude in results without including them in a query
The Allele Query Tool works by constructing a URL for the query. This URL can then be copied and sent to a collaborator to generate the same results of the query or bookmarked if you intend to execute the query multiple times.

Allele Name Query

The Allele Name Query tab allows simple queries on the IPD Accession, Allele Name and Previous Nomenclature fields.

Below is a worked example:

Allele Name Query Example


This example queries the database for all alleles which start with A*02:01.

Advanced Query

The Advanced Query tab allows for the construction of custom queries to the database. First a field is selected from the dropdown. For a list of available fields and their meaning please see Allele list Fields documentation. If relevant an operator can then be selected from a dropdown. Lastly a user input for the query is required which depending on the field can be text, date or selected from a drop down. Multiple fields can be selected for a single query and can be joined by either an "and", "or" or "nor" connectors. These fields can also be grouped to perform larger more complex queries.

Below is a worked example:

Advanced Query Example


This example queries the database for all alleles which belong to locus HLA-A* and have either have not been confirmed or have incomplete CDS.

Field Select

The Display Fields tab allows users to select additional fields to display that are not being queried. These fields are selected from a dropdown and the currently displayed fields are presented below. The field select tab can be used in combination with either the Advanced Query tab or the Allele Name Query tab.

Below is a worked example:

Field Example


This example performs an Allele Name Query to the database for alleles containing A*01. It then additionally displays the P and G groups.