Skip to main content
POST
Reports aggregate allele counts and frequencies from the Genome Aggregation Database (gnomAD), Broad Institute, showing what a public reference population contains, by genetic ancestry group. For research; not medical advice. An rsID matching several variants needs the variant_id.

​
Authentication

Requires x402 payment in the payment-signature header.

​
Request Body

​
string
gnomAD variant ID on GRCh38, for example 1-55051215-G-GA; supply only variant_id or rsid.
​
string
dbSNP identifier, for example rs527413419; supply only rsid or variant_id.

​
Response (200 OK)

Top-level envelope: success (boolean) and data (object). All fields below are nested under data.
​
string
Durable job ID for audit and lookup
​
string
Job status: completed
​
string
Always variant_frequency
​
object
The answer, described under Result below
​
object
Where the answer came from and when
​
string
The public body the data comes from. Always Genome Aggregation Database (gnomAD), Broad Institute.
​
string
public when the data comes from a public body, commercial otherwise
​
string
When the lookup was made, as an ISO 8601 UTC time
​
string | null
No date is supplied by the source; data refresh per versioned release.

​
Result

Nested under data.result.
​
boolean
Found.
​
string | null
Note. null when the source gives no value.
​
string | null
Variant id. null when the source gives no value.
​
string[]
Rsids.
​
string | null
Reference genome. null when the source gives no value.
​
string | null
Chrom. null when the source gives no value.
​
integer | null
Pos. null when the source gives no value.
​
string | null
Ref. null when the source gives no value.
​
string | null
Alt. null when the source gives no value.
​
object | null
Exome. null when the source gives no value.
​
integer
Allele count.
​
integer
Allele number.
​
number | null
Allele frequency. null when the source gives no value.
​
integer
Homozygotes.
​
integer
Hemizygotes.
​
string[]
Empty means it passed quality filters.
​
object[]
Populations.
​
string
Group.
​
integer
Allele count.
​
integer
Allele number.
​
number | null
Allele frequency. null when the source gives no value.
​
integer
Homozygotes.
​
object | null
Genome. null when the source gives no value.
​
integer
Allele count.
​
integer
Allele number.
​
number | null
Allele frequency. null when the source gives no value.
​
integer
Homozygotes.
​
integer
Hemizygotes.
​
string[]
Empty means it passed quality filters.
​
object[]
Populations.
​
string
Group.
​
integer
Allele count.
​
integer
Allele number.
​
number | null
Allele frequency. null when the source gives no value.
​
integer
Homozygotes.
See Pricing for this tool’s price. A wallet (x402) call receives it in the 402 quote before anything is charged; a call paid from prepaid credits is charged when the API accepts the request and answers 200.

​
Notes

  • Supply one variant identifier, never a person’s genome, sequencing data or a VCF file.
  • Uses gnomAD v4 (GRCh38), exomes and genomes. Data refresh per versioned release; no observation date is supplied.
  • Primary exome and genome data are CC0 1.0. Never try to reidentify participants.
  • Only ancestry groups are returned; sex splits, reference-panel subsets and other annotations are excluded.
  • An absent data type is null. Allele frequency is allele count divided by allele number, or null when the denominator is zero.
  • Results return inline. The finished job stays available at /v1/requests/{request_id}