# MyVariant.info

> Look up human genetic variants in MyVariant.info, which combines ClinVar, dbSNP, gnomAD, CADD, dbNSFP, COSMIC and more: get a variant by its HGVS ID or rsID with its gene, ClinVar classification, CADD score and allele frequency, search and count variants in a gene or region, and summarize a gene's ClinVar classifications.

App · 8 actions. Web page: https://docs.lodol.com/docs/integrations/myvariant

## Actions

### Count variants

Count the variants matching your filters by variant type, gene, or AlphaMissense, SIFT or PolyPhen-2 prediction, the largest group first, such as how many of a gene's variants are deletions.

**Inputs**

- Group by (`group_by`, text): What to count the variants by. Defaults to variant type. One of: `variant_type` (Variant type), `gene`, `alphamissense` (AlphaMissense prediction), `sift` (SIFT prediction), `polyphen` (PolyPhen-2 prediction). Default: `variant_type`.
- Search for (`query`, text): Words or an ID to look for, such as p.V600E, or a search on one field, such as dbsnp.vartype:del or exac.af:<0.001. AND, OR and NOT work. Leave blank to use only the filters.
- Gene (`gene`, text): Only variants in this gene, by its symbol, such as BRCA1.
- ClinVar classification (`clinical_significance`, list): Only variants with at least one ClinVar record classed one of these ways. Leave blank for any. One or more of: `pathogenic` (Pathogenic or likely pathogenic), `uncertain` (Uncertain significance), `benign` (Benign or likely benign), `conflicting` (Conflicting classifications), `drug_response` (Drug response), `risk_factor` (Risk factor), `not_provided` (Not provided).
- Lowest CADD score (`min_cadd_score`, number): Only variants with a CADD score this high or higher, from 0 to 99: 20 or more is the 1% most likely to be harmful. GRCh37 (hg19) only. From 0 to 99.
- Highest allele frequency (`max_allele_frequency`, number): Leave out variants more common than this in gnomAD, from 0 to 1, such as 0.01 for rarer than 1%. Variants gnomAD hasn't seen are kept. From 0 to 1.
- Only variants found in (`found_in`, list): Only variants these sources have data on, such as ClinVar or gnomAD genomes. Leave blank for any. One or more of: `clinvar`, `dbsnp`, `gnomad_genome` (gnomAD genomes), `gnomad_exome` (gnomAD exomes), `dbnsfp` (dbNSFP (missense predictions)), `cosmic` (COSMIC (GRCh37 only)), `civic` (CIViC (GRCh37 only)), `cadd` (CADD (GRCh37 only)), `gwassnps` (GWAS Catalog (GRCh37 only)).
- Genome build (`assembly`, text): Which reference genome positions are on. Defaults to GRCh37 (hg19), MyVariant.info's own; some sources, such as CADD and COSMIC, are on GRCh37 only. One of: `hg19` (GRCh37 (hg19)), `hg38` (GRCh38 (hg38)). Default: `hg19`.
- Most groups (`max_groups`, number): The most groups to list, largest first, from 1 to 1,000. Defaults to 20. From 1 to 1000. Default: `20`.

**Outputs**

- `assembly` (text): The genome build searched
- `count` (number): How many groups are listed
- `group_by` (text): What the variants were counted by
- `groups` (list): One row per value, the largest first
- `query` (text): The search sent to MyVariant.info, filters included
- `summary` (text): The largest groups, in one line
- `total` (number): How many variants match in all
- `with_value` (number): How many matching variants have a value to count

**Example output**

```json
{
  "assembly": "hg19",
  "count": 5,
  "group_by": "variant_type",
  "groups": [
    {
      "code": "snv",
      "count": 85734,
      "percent": 88.9,
      "value": "single nucleotide variant"
    },
    {
      "code": "delins",
      "count": 8250,
      "percent": 8.6,
      "value": "deletion and insertion"
    },
    {
      "code": "del",
      "count": 1664,
      "percent": 1.7,
      "value": "deletion"
    },
    {
      "code": "ins",
      "count": 804,
      "percent": 0.8,
      "value": "insertion"
    },
    {
      "code": "mnv",
      "count": 26,
      "percent": 0.0,
      "value": "multiple nucleotide variant"
    }
  ],
  "query": "(dbsnp.gene.symbol:BRAF OR clinvar.gene.symbol:BRAF)",
  "summary": "96,835 variants matching; by variant type: single nucleotide variant 85,734, deletion and insertion 8,250, deletion 1,664.",
  "total": 96835,
  "with_value": 96478
}
```

### Get a variant

Look up a genetic variant by its HGVS ID, rsID, ClinVar or COSMIC ID, or transcript change, and get its gene, what it does to the protein, how ClinVar classifies it and for which conditions, its CADD score and predictions, and how common it is in gnomAD.

**Inputs**

- Variant (`variant`, text, required): The variant, such as chr7:g.140453136A>T, rs113488022, NC_000007.13:g.140453136A>T, ClinVar's 13961 or RCV000014992, COSM476 or NM_004333.6:c.1799T>A, or the address of its ClinVar or dbSNP page.
- Alternate allele (`alternate_allele`, text): For an rsID with several alternate alleles at one position, which to return, such as T. Leave blank for the one ClinVar classifies; the others are listed under alleles.
- Genome build (`assembly`, text): Which reference genome positions are on. Defaults to GRCh37 (hg19), MyVariant.info's own; some sources, such as CADD and COSMIC, are on GRCh37 only. One of: `hg19` (GRCh37 (hg19)), `hg38` (GRCh38 (hg38)). Default: `hg19`.
- Extra fields (`extra_fields`, list): More of each variant's record to return, under fields: a whole source such as clinvar, or part of one such as clinvar.rcv or gnomad_exome.af. List available fields describes them all.

**Outputs**

- `allele_frequency` (number): How common the alternate allele is in gnomAD, from 0 to 1: its genomes when it has them, otherwise its exomes
- `alleles` (list): Every variant what was asked for names: for an rsID at a position with several alternate alleles, one per allele, this one included
- `alphamissense` (text): AlphaMissense's prediction: likely pathogenic, ambiguous or likely benign
- `alt` (text): The alternate allele, such as T
- `assembly` (text): The genome build the position is on: hg19 or hg38
- `cadd_score` (number): Its CADD score (phred scale): 20 or more puts it in the 1% most likely to be harmful, 30 or more in the 0.1%
- `chromosome` (text): The chromosome, such as 7, X or MT
- `clinical_significance` (text): What most of ClinVar's records say about it, such as Pathogenic, Uncertain significance or Benign
- `clinical_significances` (list): Every classification its ClinVar records give, the most common first
- `clinvar_url` (text): Its page on ClinVar
- `clinvar_variation_id` (number): ClinVar's variation ID for it, such as 13961
- `coding_change` (text): The change in the coding sequence, such as c.1799T>A
- `conditions` (list): The conditions ClinVar's records name for it
- `consequence` (text): What the change does to the gene, such as missense variant or intron variant
- `cosmic_id` (text): Its COSMIC ID, for a variant seen in cancers, such as COSM476
- `dbsnp_url` (text): Its page on dbSNP
- `end` (number): Where the variant ends on the chromosome
- `fields` (object): The Extra fields asked for, by name (such as clinvar.rcv or gnomad_exome.af), as MyVariant.info gives them
- `gene` (text): The gene symbol the variant is in or near, such as BRAF
- `gnomad_exome_frequency` (number): Its allele frequency in gnomAD's exomes
- `gnomad_genome_frequency` (number): Its allele frequency in gnomAD's genomes
- `impact` (text): How disruptive the change is likely to be: high, moderate, low
- `polyphen` (text): PolyPhen-2's prediction: probably damaging, possibly damaging or benign
- `position` (number): Where the variant starts on the chromosome
- `protein_change` (text): The change in the protein, such as p.Val600Glu
- `query` (text): What was asked for that found this variant, as it was given
- `ref` (text): The reference allele, such as A
- `rsid` (text): The dbSNP reference SNP ID, such as rs113488022
- `sift` (text): SIFT's prediction: deleterious or tolerated
- `summary` (text): One line about the variant: its gene, consequence, ClinVar classification, CADD score and how common it is
- `transcript` (text): The transcript the change is described on, such as NM_004333.4
- `variant_id` (text): MyVariant.info's ID for the variant: its genomic HGVS name, such as chr7:g.140453136A>T
- `variant_type` (text): The kind of change, such as snv, del, ins or delins

**Example output**

```json
{
  "allele_frequency": 3.97994e-06,
  "alleles": [
    {
      "alt": "G",
      "clinical_significance": null,
      "variant_id": "chr7:g.140453136A>G"
    },
    {
      "alt": "T",
      "clinical_significance": "Pathogenic",
      "variant_id": "chr7:g.140453136A>T"
    },
    {
      "alt": "C",
      "clinical_significance": "not provided",
      "variant_id": "chr7:g.140453136A>C"
    }
  ],
  "alphamissense": "likely pathogenic",
  "alt": "T",
  "assembly": "hg19",
  "cadd_score": 32.0,
  "chromosome": "7",
  "clinical_significance": "Pathogenic",
  "clinical_significances": [
    {
      "records": 3,
      "significance": "Pathogenic"
    }
  ],
  "clinvar_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/13961/",
  "clinvar_variation_id": 13961,
  "coding_change": "c.1799T>A",
  "conditions": [
    "Carcinoma of colon (CRC)",
    "Papillary thyroid carcinoma",
    "Astrocytoma, low-grade, somatic"
  ],
  "consequence": "missense variant",
  "cosmic_id": "COSM476",
  "dbsnp_url": "https://www.ncbi.nlm.nih.gov/snp/rs113488022",
  "end": 140453136,
  "fields": {},
  "gene": "BRAF",
  "gnomad_exome_frequency": 3.97994e-06,
  "gnomad_genome_frequency": null,
  "impact": "moderate",
  "polyphen": "probably damaging",
  "position": 140453136,
  "protein_change": "p.Val600Glu",
  "query": "rs113488022",
  "ref": "A",
  "rsid": "rs113488022",
  "sift": "deleterious",
  "summary": "chr7:g.140453136A>T (rs113488022) in BRAF: missense variant, p.Val600Glu. ClinVar: Pathogenic. CADD 32. gnomAD frequency 1 in 251,000.",
  "transcript": "NM_004333.4",
  "variant_id": "chr7:g.140453136A>T",
  "variant_type": "snv"
}
```

### Get database information

Get which release of MyVariant.info is live and when it was built, how many variants a genome build holds, and each source database's version, size and when it was loaded.

**Inputs**

- Genome build (`assembly`, text): Which reference genome positions are on. Defaults to GRCh37 (hg19), MyVariant.info's own; some sources, such as CADD and COSMIC, are on GRCh37 only. One of: `hg19` (GRCh37 (hg19)), `hg38` (GRCh38 (hg38)). Default: `hg19`.

**Outputs**

- `assembly` (text): The genome build described
- `build_date` (text): When the release was built (YYYY-MM-DD)
- `build_version` (text): MyVariant.info's release, such as 20250624
- `source_count` (number): How many sources it combines
- `sources` (list): The databases it combines, by name
- `summary` (text): The release and its size
- `total_variants` (number): How many variants this genome build holds

**Example output**

```json
{
  "assembly": "hg19",
  "build_date": "2025-06-24",
  "build_version": "20250624",
  "source_count": 19,
  "sources": [
    {
      "license": null,
      "name": "cadd",
      "title": "CADD",
      "updated": "2019-07-25",
      "url": "http://cadd.gs.washington.edu/home",
      "variants": 226932858,
      "version": null
    },
    {
      "license": "CC0 1.0 Universal",
      "name": "cgi",
      "title": "Cancer Genome Interpreter",
      "updated": "2025-02-19",
      "url": "https://www.cancergenomeinterpreter.org/home",
      "variants": 323,
      "version": "2023-02-27"
    },
    {
      "license": "CC0 1.0 Universal",
      "name": "civic",
      "title": "CIViC",
      "updated": "2025-05-22",
      "url": "https://civicdb.org",
      "variants": 4643,
      "version": "2025-05-22"
    },
    {
      "license": null,
      "name": "clinvar",
      "title": "ClinVar",
      "updated": "2025-05-22",
      "url": "https://www.ncbi.nlm.nih.gov/clinvar/",
      "variants": 3483037,
      "version": "2025-05"
    },
    {
      "license": null,
      "name": "cosmic",
      "title": "COSMIC",
      "updated": "2019-02-27",
      "url": "http://cancer.sanger.ac.uk/cosmic",
      "variants": 1024494,
      "version": "68"
    },
    {
      "license": null,
      "name": "dbnsfp",
      "title": "dbNSFP",
      "updated": "2025-02-19",
      "url": "https://sites.google.com/site/jpopgen/dbNSFP",
      "variants": 82755468,
      "version": "4.8a"
    },
    {
      "license": null,
      "name": "dbsnp",
      "title": "dbSNP",
      "updated": "2022-02-18",
      "url": "https://www.ncbi.nlm.nih.gov/projects/SNP/",
      "variants": 1251548848,
      "version": "156"
    },
    {
      "license": null,
      "name": "docm",
      "title": "DoCM",
      "updated": "2019-02-27",
      "url": null,
      "variants": 1119,
      "version": null
    },
    {
      "license": null,
      "name": "emv",
      "title": "EmVClass",
      "updated": "2019-05-23",
      "url": "http://www.egl-eurofins.com/emvclass/emvclass.php",
      "variants": 43644,
      "version": "2018-Q2"
    },
    {
      "license": null,
      "name": "evs",
      "title": "Exome Variant Server",
      "updated": "2019-02-27",
      "url": "http://evs.gs.washington.edu/EVS/",
      "variants": 1977300,
      "version": "2"
    },
    {
      "license": "ODbL",
      "name": "exac",
      "title": "ExAC",
      "updated": "2025-02-18",
      "url": "http://exac.broadinstitute.org/",
      "variants": 19520462,
      "version": "0.3.1"
    },
    {
      "license": null,
      "name": "geno2mp",
      "title": "Geno2MP",
      "updated": "2025-02-19",
      "url": "http://geno2mp.gs.washington.edu",
      "variants": 37885228,
      "version": "2021-09-17"
    },
    {
      "license": "ODbL",
      "name": "gnomad",
      "title": "gnomAD",
      "updated": "2019-12-02",
      "url": "http://gnomad.broadinstitute.org",
      "variants": 279152308,
      "version": "2.1.1"
    },
    {
      "license": null,
      "name": "grasp",
      "title": "GRASP",
      "updated": "2019-02-27",
      "url": "https://grasp.nhlbi.nih.gov/Updates.aspx",
      "variants": 2473750,
      "version": "2.0.0.0"
    },
    {
      "license": null,
      "name": "gwassnps",
      "title": "GWAS Catalog",
      "updated": "2019-02-27",
      "url": "http://www.ebi.ac.uk/gwas/",
      "variants": 15243,
      "version": null
    },
    {
      "license": null,
      "name": "mutdb",
      "title": "MutDB",
      "updated": "2019-02-27",
      "url": "http://www.mutdb.org/",
      "variants": 420221,
      "version": null
    },
    {
      "license": "CC BY-NC-SA",
      "name": "snpedia",
      "title": "SNPedia",
      "updated": "2019-02-27",
      "url": "https://www.snpedia.com/",
      "variants": 5907,
      "version": null
    },
    {
      "license": "LGPLv3",
      "name": "snpeff",
      "title": "SnpEff",
      "updated": "2025-02-18",
      "url": "http://snpeff.sourceforge.net/",
      "variants": 1464410470,
      "version": "4.3k"
    },
    {
      "license": null,
      "name": "wellderly",
      "title": "Wellderly",
      "updated": "2019-02-27",
      "url": "https://genomics.scripps.edu/browser/",
      "variants": 75529059,
      "version": null
    }
  ],
  "summary": "MyVariant.info release 20250624 (2025-06-24) holds 1,510,665,168 variants on GRCh37 (hg19) from 19 sources.",
  "total_variants": 1510665168
}
```

### Get several variants

Look up to 1,000 variants in one step, by any mix of the IDs Get a variant takes, such as a spreadsheet column of rsIDs, each with the same key facts. IDs that match nothing are listed separately.

**Inputs**

- Variants (`variants`, list, required): The variants, as a list or separated by commas or new lines, such as chr7:g.140453136A>T, rs58991260.
- Genome build (`assembly`, text): Which reference genome positions are on. Defaults to GRCh37 (hg19), MyVariant.info's own; some sources, such as CADD and COSMIC, are on GRCh37 only. One of: `hg19` (GRCh37 (hg19)), `hg38` (GRCh38 (hg38)). Default: `hg19`.
- Extra fields (`extra_fields`, list): More of each variant's record to return, under fields: a whole source such as clinvar, or part of one such as clinvar.rcv or gnomad_exome.af. List available fields describes them all.

**Outputs**

- `count` (number): How many variants came back
- `not_found` (list): What was asked for that matched no variant
- `summary` (text): How many were found and missed
- `variants` (list): The variants found, in the order they were asked for

**Example output**

```json
{
  "count": 3,
  "not_found": [
    "rs000"
  ],
  "summary": "Found 3 variants; nothing matched rs000.",
  "variants": [
    {
      "allele_frequency": 3.97994e-06,
      "alphamissense": "likely pathogenic",
      "alt": "T",
      "assembly": "hg19",
      "cadd_score": 32.0,
      "chromosome": "7",
      "clinical_significance": "Pathogenic",
      "clinical_significances": [
        {
          "records": 3,
          "significance": "Pathogenic"
        }
      ],
      "clinvar_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/13961/",
      "clinvar_variation_id": 13961,
      "coding_change": "c.1799T>A",
      "conditions": [
        "Carcinoma of colon (CRC)",
        "Papillary thyroid carcinoma",
        "Astrocytoma, low-grade, somatic"
      ],
      "consequence": "missense variant",
      "cosmic_id": "COSM476",
      "dbsnp_url": "https://www.ncbi.nlm.nih.gov/snp/rs113488022",
      "end": 140453136,
      "fields": {},
      "gene": "BRAF",
      "gnomad_exome_frequency": 3.97994e-06,
      "gnomad_genome_frequency": null,
      "impact": "moderate",
      "polyphen": "probably damaging",
      "position": 140453136,
      "protein_change": "p.Val600Glu",
      "query": "chr7:g.140453136A>T",
      "ref": "A",
      "rsid": "rs113488022",
      "sift": "deleterious",
      "summary": "chr7:g.140453136A>T (rs113488022) in BRAF: missense variant, p.Val600Glu. ClinVar: Pathogenic. CADD 32. gnomAD frequency 1 in 251,000.",
      "transcript": "NM_004333.4",
      "variant_id": "chr7:g.140453136A>T",
      "variant_type": "snv"
    },
    {
      "allele_frequency": 0.0150338,
      "alphamissense": null,
      "alt": "A",
      "assembly": "hg19",
      "cadd_score": 1.679,
      "chromosome": "1",
      "clinical_significance": null,
      "clinical_significances": [],
      "clinvar_url": null,
      "clinvar_variation_id": null,
      "coding_change": "n.21+20783G>A",
      "conditions": [],
      "consequence": "intron variant",
      "cosmic_id": null,
      "dbsnp_url": "https://www.ncbi.nlm.nih.gov/snp/rs58991260",
      "end": 218631822,
      "fields": {},
      "gene": "MIR548F3",
      "gnomad_exome_frequency": null,
      "gnomad_genome_frequency": 0.0150338,
      "impact": "modifier",
      "polyphen": null,
      "position": 218631822,
      "protein_change": null,
      "query": "rs58991260",
      "ref": "G",
      "rsid": "rs58991260",
      "sift": null,
      "summary": "chr1:g.218631822G>A (rs58991260) in MIR548F3: intron variant. Not in ClinVar. CADD 1.679. gnomAD frequency 1.5%.",
      "transcript": "NR_031644.1",
      "variant_id": "chr1:g.218631822G>A",
      "variant_type": "snv"
    },
    {
      "allele_frequency": 3.97848e-06,
      "alphamissense": null,
      "alt": "T",
      "assembly": "hg19",
      "cadd_score": null,
      "chromosome": "17",
      "clinical_significance": "Pathogenic",
      "clinical_significances": [
        {
          "records": 3,
          "significance": "Pathogenic"
        }
      ],
      "clinvar_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/37629/",
      "clinvar_variation_id": 37629,
      "coding_change": "c.5137+1G>A",
      "conditions": [
        "Breast-ovarian cancer, familial, susceptibility to, 1 (BROVCA1)",
        "Hereditary breast ovarian cancer syndrome",
        "Hereditary cancer-predisposing syndrome"
      ],
      "consequence": "splice donor variant, intron variant",
      "cosmic_id": null,
      "dbsnp_url": "https://www.ncbi.nlm.nih.gov/snp/rs80358053",
      "end": 41219624,
      "fields": {},
      "gene": "BRCA1",
      "gnomad_exome_frequency": 3.97848e-06,
      "gnomad_genome_frequency": null,
      "impact": "high",
      "polyphen": null,
      "position": 41219624,
      "protein_change": null,
      "query": "NM_007294.4:c.5074+1G>A",
      "ref": "C",
      "rsid": "rs80358053",
      "sift": null,
      "summary": "chr17:g.41219624C>T (rs80358053) in BRCA1: splice donor variant, intron variant. ClinVar: Pathogenic. gnomAD frequency 1 in 251,000.",
      "transcript": "NM_007300.3",
      "variant_id": "chr17:g.41219624C>T",
      "variant_type": "snv"
    }
  ]
}
```

### List available fields

List the fields a variant record can have, such as clinvar.rcv.clinical_significance or gnomad_exome.af.af, to use in Extra fields or to search one field.

**Inputs**

- Name contains (`search`, text): Only fields whose name contains this, such as clinvar.
- Genome build (`assembly`, text): Which reference genome positions are on. Defaults to GRCh37 (hg19), MyVariant.info's own; some sources, such as CADD and COSMIC, are on GRCh37 only. One of: `hg19` (GRCh37 (hg19)), `hg38` (GRCh38 (hg38)). Default: `hg19`.

**Outputs**

- `assembly` (text): The genome build described
- `count` (number): How many fields are listed
- `fields` (list): The fields, by name

**Example output**

```json
{
  "assembly": "hg19",
  "count": 14,
  "fields": [
    {
      "name": "clinvar.rcv.clinical_significance",
      "searchable": true,
      "source": "clinvar",
      "type": "text"
    },
    {
      "name": "clinvar.rcv.conditions",
      "searchable": true,
      "source": "clinvar",
      "type": "object"
    },
    {
      "name": "clinvar.rcv.conditions.age_of_onset",
      "searchable": true,
      "source": "clinvar",
      "type": "text"
    },
    {
      "name": "clinvar.rcv.conditions.identifiers",
      "searchable": true,
      "source": "clinvar",
      "type": "object"
    },
    {
      "name": "clinvar.rcv.conditions.identifiers.efo",
      "searchable": true,
      "source": "clinvar",
      "type": "text"
    },
    {
      "name": "clinvar.rcv.conditions.identifiers.gene",
      "searchable": true,
      "source": "clinvar",
      "type": "text"
    },
    {
      "name": "clinvar.rcv.conditions.identifiers.human_phenotype_ontology",
      "searchable": true,
      "source": "clinvar",
      "type": "text"
    },
    {
      "name": "clinvar.rcv.conditions.identifiers.medgen",
      "searchable": true,
      "source": "clinvar",
      "type": "text"
    },
    {
      "name": "clinvar.rcv.conditions.identifiers.mesh",
      "searchable": true,
      "source": "clinvar",
      "type": "text"
    },
    {
      "name": "clinvar.rcv.conditions.identifiers.mondo",
      "searchable": true,
      "source": "clinvar",
      "type": "text"
    },
    {
      "name": "clinvar.rcv.conditions.identifiers.omim",
      "searchable": true,
      "source": "clinvar",
      "type": "text"
    },
    {
      "name": "clinvar.rcv.conditions.identifiers.orphanet",
      "searchable": true,
      "source": "clinvar",
      "type": "text"
    },
    {
      "name": "clinvar.rcv.conditions.name",
      "searchable": true,
      "source": "clinvar",
      "type": "text"
    },
    {
      "name": "clinvar.rcv.conditions.synonyms",
      "searchable": true,
      "source": "clinvar",
      "type": "text"
    }
  ]
}
```

### List variants in a region

List the variants between two positions on a chromosome, in order, optionally only those in ClinVar or another source or with a given ClinVar classification. A region can span up to 1,000,000 positions.

**Inputs**

- Chromosome (`chromosome`, text, required): The chromosome the region is on. One of: `1` (Chromosome 1), `2` (Chromosome 2), `3` (Chromosome 3), `4` (Chromosome 4), `5` (Chromosome 5), `6` (Chromosome 6), `7` (Chromosome 7), `8` (Chromosome 8), `9` (Chromosome 9), `10` (Chromosome 10), and 15 more.
- Start (`start`, number, required): The first position of the region, such as 140453126. From 1 to 250000000.
- End (`end`, number, required): The last position of the region, such as 140453146, at most 1,000,000 positions after Start. From 1 to 250000000.
- Genome build (`assembly`, text): Which reference genome positions are on. Defaults to GRCh37 (hg19), MyVariant.info's own; some sources, such as CADD and COSMIC, are on GRCh37 only. One of: `hg19` (GRCh37 (hg19)), `hg38` (GRCh38 (hg38)). Default: `hg19`.
- ClinVar classification (`clinical_significance`, list): Only variants with at least one ClinVar record classed one of these ways. Leave blank for any. One or more of: `pathogenic` (Pathogenic or likely pathogenic), `uncertain` (Uncertain significance), `benign` (Benign or likely benign), `conflicting` (Conflicting classifications), `drug_response` (Drug response), `risk_factor` (Risk factor), `not_provided` (Not provided).
- Only variants found in (`found_in`, list): Only variants these sources have data on, such as ClinVar or gnomAD genomes. Leave blank for any. One or more of: `clinvar`, `dbsnp`, `gnomad_genome` (gnomAD genomes), `gnomad_exome` (gnomAD exomes), `dbnsfp` (dbNSFP (missense predictions)), `cosmic` (COSMIC (GRCh37 only)), `civic` (CIViC (GRCh37 only)), `cadd` (CADD (GRCh37 only)), `gwassnps` (GWAS Catalog (GRCh37 only)).
- Max results (`max_results`, number): How many variants to return, from 1 to 1,000. Defaults to 10. From 1 to 1000. Default: `10`.
- Skip (`skip`, number): How many matching variants to skip, for the next page: use the previous step's next_skip. Skip plus Max results can be at most 10,000. From 0 to 9999. Default: `0`.
- Extra fields (`extra_fields`, list): More of each variant's record to return, under fields: a whole source such as clinvar, or part of one such as clinvar.rcv or gnomad_exome.af. List available fields describes them all.

**Outputs**

- `assembly` (text): The genome build of the region
- `count` (number): How many variants are on this page
- `has_more` (true/false): Whether there are more matching variants after this page
- `next_skip` (number): The Skip that gets the next page, when there is one
- `region` (text): The region listed, such as chr7:140453126-140453146
- `skip` (number): How many matching variants came before this page
- `summary` (text): How many matched and were listed
- `total` (number): How many variants match in all
- `variants` (list): The variants on this page

**Example output**

```json
{
  "assembly": "hg19",
  "count": 3,
  "has_more": true,
  "next_skip": 3,
  "region": "chr7:140453126-140453146",
  "skip": 0,
  "summary": "22 variants in chr7:140453126-140453146 (hg19); showing 1 to 3.",
  "total": 22,
  "variants": [
    {
      "allele_frequency": null,
      "alphamissense": null,
      "alt": "A",
      "assembly": "hg19",
      "cadd_score": 48.0,
      "chromosome": "7",
      "clinical_significance": "Uncertain significance",
      "clinical_significances": [
        {
          "records": 2,
          "significance": "Uncertain significance"
        },
        {
          "records": 1,
          "significance": "not provided"
        }
      ],
      "clinvar_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/132952/",
      "clinvar_variation_id": 132952,
      "coding_change": "c.1807C>T",
      "conditions": [
        "Endometrial carcinoma",
        "RASopathy"
      ],
      "consequence": "stop gained",
      "cosmic_id": "COSM33729",
      "dbsnp_url": "https://www.ncbi.nlm.nih.gov/snp/rs104886015",
      "end": 140453128,
      "fields": {},
      "gene": "BRAF",
      "gnomad_exome_frequency": null,
      "gnomad_genome_frequency": null,
      "impact": "high",
      "polyphen": null,
      "position": 140453128,
      "protein_change": "p.Arg603*",
      "query": null,
      "ref": "G",
      "rsid": "rs104886015",
      "sift": null,
      "summary": "chr7:g.140453128G>A (rs104886015) in BRAF: stop gained, p.Arg603*. ClinVar: Uncertain significance. CADD 48. Not in gnomAD.",
      "transcript": "NM_004333.4",
      "variant_id": "chr7:g.140453128G>A",
      "variant_type": "snv"
    },
    {
      "allele_frequency": null,
      "alphamissense": "likely pathogenic",
      "alt": "G",
      "assembly": "hg19",
      "cadd_score": 24.1,
      "chromosome": "7",
      "clinical_significance": "Uncertain significance",
      "clinical_significances": [
        {
          "records": 1,
          "significance": "Uncertain significance"
        }
      ],
      "clinvar_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/376286/",
      "clinvar_variation_id": 376286,
      "coding_change": "c.1803A>C",
      "conditions": [
        "RASopathy"
      ],
      "consequence": "missense variant",
      "cosmic_id": "COSM1132",
      "dbsnp_url": "https://www.ncbi.nlm.nih.gov/snp/rs121913365",
      "end": 140453132,
      "fields": {},
      "gene": "BRAF",
      "gnomad_exome_frequency": null,
      "gnomad_genome_frequency": null,
      "impact": "moderate",
      "polyphen": "benign",
      "position": 140453132,
      "protein_change": "p.Lys601Asn",
      "query": null,
      "ref": "T",
      "rsid": "rs121913365",
      "sift": "deleterious",
      "summary": "chr7:g.140453132T>G (rs121913365) in BRAF: missense variant, p.Lys601Asn. ClinVar: Uncertain significance. CADD 24.1. Not in gnomAD.",
      "transcript": "NM_004333.4",
      "variant_id": "chr7:g.140453132T>G",
      "variant_type": "snv"
    },
    {
      "allele_frequency": null,
      "alphamissense": "likely pathogenic",
      "alt": "A",
      "assembly": "hg19",
      "cadd_score": 33.0,
      "chromosome": "7",
      "clinical_significance": "Pathogenic",
      "clinical_significances": [
        {
          "records": 2,
          "significance": "Pathogenic"
        },
        {
          "records": 1,
          "significance": "Likely pathogenic"
        }
      ],
      "clinvar_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/40390/",
      "clinvar_variation_id": 40390,
      "coding_change": "c.1802A>T",
      "conditions": [
        "RASopathy",
        "Cardio-facio-cutaneous syndrome",
        "Cardiofaciocutaneous syndrome 1 (CFC1)"
      ],
      "consequence": "missense variant",
      "cosmic_id": "COSM26491",
      "dbsnp_url": "https://www.ncbi.nlm.nih.gov/snp/rs397507484",
      "end": 140453133,
      "fields": {},
      "gene": "BRAF",
      "gnomad_exome_frequency": null,
      "gnomad_genome_frequency": null,
      "impact": "moderate",
      "polyphen": "possibly damaging",
      "position": 140453133,
      "protein_change": "p.Lys601Ile",
      "query": null,
      "ref": "T",
      "rsid": "rs397507484",
      "sift": "deleterious",
      "summary": "chr7:g.140453133T>A (rs397507484) in BRAF: missense variant, p.Lys601Ile. ClinVar: Pathogenic. CADD 33. Not in gnomAD.",
      "transcript": "NM_004333.4",
      "variant_id": "chr7:g.140453133T>A",
      "variant_type": "snv"
    }
  ]
}
```

### Search variants

Find variants in a gene, by ClinVar classification, CADD score, how rare they are in gnomAD, the sources they are in, or any search text, a page at a time, best match, highest CADD score or rarest first.

**Inputs**

- Search for (`query`, text): Words or an ID to look for, such as p.V600E, or a search on one field, such as dbsnp.vartype:del or exac.af:<0.001. AND, OR and NOT work. Leave blank to use only the filters.
- Gene (`gene`, text): Only variants in this gene, by its symbol, such as BRCA1.
- ClinVar classification (`clinical_significance`, list): Only variants with at least one ClinVar record classed one of these ways. Leave blank for any. One or more of: `pathogenic` (Pathogenic or likely pathogenic), `uncertain` (Uncertain significance), `benign` (Benign or likely benign), `conflicting` (Conflicting classifications), `drug_response` (Drug response), `risk_factor` (Risk factor), `not_provided` (Not provided).
- Lowest CADD score (`min_cadd_score`, number): Only variants with a CADD score this high or higher, from 0 to 99: 20 or more is the 1% most likely to be harmful. GRCh37 (hg19) only. From 0 to 99.
- Highest allele frequency (`max_allele_frequency`, number): Leave out variants more common than this in gnomAD, from 0 to 1, such as 0.01 for rarer than 1%. Variants gnomAD hasn't seen are kept. From 0 to 1.
- Only variants found in (`found_in`, list): Only variants these sources have data on, such as ClinVar or gnomAD genomes. Leave blank for any. One or more of: `clinvar`, `dbsnp`, `gnomad_genome` (gnomAD genomes), `gnomad_exome` (gnomAD exomes), `dbnsfp` (dbNSFP (missense predictions)), `cosmic` (COSMIC (GRCh37 only)), `civic` (CIViC (GRCh37 only)), `cadd` (CADD (GRCh37 only)), `gwassnps` (GWAS Catalog (GRCh37 only)).
- Sort (`sort`, text): Which variants come first. Defaults to best match. One of: `best_match` (Best match first), `cadd_desc` (Highest CADD score first (GRCh37 only)), `rarest` (Rarest in gnomAD first), `commonest` (Most common in gnomAD first), `position` (By position on the chromosome). Default: `best_match`.
- Genome build (`assembly`, text): Which reference genome positions are on. Defaults to GRCh37 (hg19), MyVariant.info's own; some sources, such as CADD and COSMIC, are on GRCh37 only. One of: `hg19` (GRCh37 (hg19)), `hg38` (GRCh38 (hg38)). Default: `hg19`.
- Max results (`max_results`, number): How many variants to return, from 1 to 1,000. Defaults to 10. From 1 to 1000. Default: `10`.
- Skip (`skip`, number): How many matching variants to skip, for the next page: use the previous step's next_skip. Skip plus Max results can be at most 10,000. From 0 to 9999. Default: `0`.
- Extra fields (`extra_fields`, list): More of each variant's record to return, under fields: a whole source such as clinvar, or part of one such as clinvar.rcv or gnomad_exome.af. List available fields describes them all.

**Outputs**

- `assembly` (text): The genome build searched
- `count` (number): How many variants are on this page
- `has_more` (true/false): Whether there are more matching variants after this page
- `next_skip` (number): The Skip that gets the next page, when there is one
- `query` (text): The search sent to MyVariant.info, filters included
- `skip` (number): How many matching variants came before this page
- `summary` (text): How many matched and were listed
- `total` (number): How many variants match in all
- `variants` (list): The variants on this page

**Example output**

```json
{
  "assembly": "hg19",
  "count": 3,
  "has_more": true,
  "next_skip": 3,
  "query": "(dbsnp.gene.symbol:BRAF OR clinvar.gene.symbol:BRAF) AND clinvar.rcv.clinical_significance:(pathogenic) AND cadd.phred:>=30",
  "skip": 0,
  "summary": "46 variants matching; showing 1 to 3.",
  "total": 46,
  "variants": [
    {
      "allele_frequency": null,
      "alphamissense": null,
      "alt": "A",
      "assembly": "hg19",
      "cadd_score": 44.0,
      "chromosome": "7",
      "clinical_significance": "Pathogenic",
      "clinical_significances": [
        {
          "records": 1,
          "significance": "Pathogenic"
        }
      ],
      "clinvar_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/690297/",
      "clinvar_variation_id": 690297,
      "coding_change": "c.1906C>T",
      "conditions": [
        "Cerebral arteriovenous malformation (BAVM)"
      ],
      "consequence": "stop gained",
      "cosmic_id": "COSM1448583",
      "dbsnp_url": "https://www.ncbi.nlm.nih.gov/snp/rs1585998247",
      "end": 140449173,
      "fields": {},
      "gene": "BRAF",
      "gnomad_exome_frequency": null,
      "gnomad_genome_frequency": null,
      "impact": "high",
      "polyphen": null,
      "position": 140449173,
      "protein_change": "p.Gln636*",
      "query": null,
      "ref": "G",
      "rsid": "rs1585998247",
      "sift": null,
      "summary": "chr7:g.140449173G>A (rs1585998247) in BRAF: stop gained, p.Gln636*. ClinVar: Pathogenic. CADD 44. Not in gnomAD.",
      "transcript": "NM_004333.4",
      "variant_id": "chr7:g.140449173G>A",
      "variant_type": "snv"
    },
    {
      "allele_frequency": null,
      "alphamissense": "likely pathogenic",
      "alt": "T",
      "assembly": "hg19",
      "cadd_score": 34.0,
      "chromosome": "7",
      "clinical_significance": "Pathogenic",
      "clinical_significances": [
        {
          "records": 2,
          "significance": "Pathogenic"
        },
        {
          "records": 1,
          "significance": "Likely pathogenic"
        }
      ],
      "clinvar_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/372572/",
      "clinvar_variation_id": 372572,
      "coding_change": "c.1390G>A",
      "conditions": [
        "RASopathy",
        "Cardio-facio-cutaneous syndrome"
      ],
      "consequence": "missense variant",
      "cosmic_id": "COSM1448615",
      "dbsnp_url": "https://www.ncbi.nlm.nih.gov/snp/rs121913349",
      "end": 140481418,
      "fields": {},
      "gene": "BRAF",
      "gnomad_exome_frequency": null,
      "gnomad_genome_frequency": null,
      "impact": "moderate",
      "polyphen": "probably damaging",
      "position": 140481418,
      "protein_change": "p.Gly464Arg",
      "query": null,
      "ref": "C",
      "rsid": "rs121913349",
      "sift": "deleterious",
      "summary": "chr7:g.140481418C>T (rs121913349) in BRAF: missense variant, p.Gly464Arg. ClinVar: Pathogenic. CADD 34. Not in gnomAD.",
      "transcript": "NM_004333.4",
      "variant_id": "chr7:g.140481418C>T",
      "variant_type": "snv"
    },
    {
      "allele_frequency": null,
      "alphamissense": "likely pathogenic",
      "alt": "A",
      "assembly": "hg19",
      "cadd_score": 34.0,
      "chromosome": "7",
      "clinical_significance": "Pathogenic",
      "clinical_significances": [
        {
          "records": 2,
          "significance": "Pathogenic"
        },
        {
          "records": 1,
          "significance": "Likely pathogenic"
        }
      ],
      "clinvar_url": "https://www.ncbi.nlm.nih.gov/clinvar/variation/40374/",
      "clinvar_variation_id": 40374,
      "coding_change": "c.1502A>T",
      "conditions": [
        "Cardio-facio-cutaneous syndrome",
        "Cardiofaciocutaneous syndrome 1 (CFC1)"
      ],
      "consequence": "missense variant",
      "cosmic_id": null,
      "dbsnp_url": "https://www.ncbi.nlm.nih.gov/snp/rs180177039",
      "end": 140477806,
      "fields": {},
      "gene": "BRAF",
      "gnomad_exome_frequency": null,
      "gnomad_genome_frequency": null,
      "impact": "moderate",
      "polyphen": "probably damaging",
      "position": 140477806,
      "protein_change": "p.Glu501Val",
      "query": null,
      "ref": "T",
      "rsid": "rs180177039",
      "sift": "deleterious",
      "summary": "chr7:g.140477806T>A (rs180177039) in BRAF: missense variant, p.Glu501Val. ClinVar: Pathogenic. CADD 34. Not in gnomAD.",
      "transcript": "NM_004333.4",
      "variant_id": "chr7:g.140477806T>A",
      "variant_type": "snv"
    }
  ]
}
```

### Summarize a gene's ClinVar variants

Count how ClinVar classifies a gene's variants: how many are pathogenic or likely pathogenic, of uncertain significance, benign or likely benign, or have conflicting classifications, with every classification given.

**Inputs**

- Gene (`gene`, text, required): The gene's symbol, such as BRCA1.

**Outputs**

- `benign_or_likely_benign` (number): Variants with at least one record classed benign or likely benign
- `complete` (true/false): Whether every one was counted; very large genes are counted up to 50,000 variants
- `conflicting` (number): Variants ClinVar lists as having conflicting classifications
- `counted_variants` (number): How many of them were counted
- `gene` (text): The gene symbol summarized
- `pathogenic_or_likely_pathogenic` (number): Variants with at least one record classed pathogenic or likely pathogenic
- `significances` (list): Every classification given, with how many variants have a record giving it, the most common first
- `summary` (text): The main counts, in one line
- `total_variants` (number): How many of the gene's variants are in ClinVar
- `uncertain_significance` (number): Variants with at least one record of uncertain significance

**Example output**

```json
{
  "benign_or_likely_benign": 644,
  "complete": true,
  "conflicting": 5,
  "counted_variants": 1384,
  "gene": "BRAF",
  "pathogenic_or_likely_pathogenic": 147,
  "significances": [
    {
      "percent": 48.6,
      "significance": "Uncertain significance",
      "variants": 672
    },
    {
      "percent": 39.7,
      "significance": "Likely benign",
      "variants": 550
    },
    {
      "percent": 9.8,
      "significance": "Benign",
      "variants": 136
    },
    {
      "percent": 7.4,
      "significance": "Pathogenic",
      "variants": 102
    },
    {
      "percent": 6.1,
      "significance": "Likely pathogenic",
      "variants": 85
    },
    {
      "percent": 1.4,
      "significance": "Benign/Likely benign",
      "variants": 19
    },
    {
      "percent": 1.4,
      "significance": "not provided",
      "variants": 19
    },
    {
      "percent": 1.3,
      "significance": "Pathogenic/Likely pathogenic",
      "variants": 18
    },
    {
      "percent": 0.4,
      "significance": "Conflicting interpretations of pathogenicity",
      "variants": 5
    },
    {
      "percent": 0.1,
      "significance": "drug response",
      "variants": 1
    }
  ],
  "summary": "BRAF has 1,384 variants in ClinVar: 147 pathogenic or likely pathogenic, 672 of uncertain significance, 644 benign or likely benign, 5 with conflicting classifications.",
  "total_variants": 1384,
  "uncertain_significance": 672
}
```
