{"openapi":"3.1.0","info":{"title":"Structural Variants API","version":"1.0.0","description":"Human genomic structural variation as an API — powered by NCBI dbVar, the archive of structural variants (SVs): copy-number variants (CNVs), large deletions, duplications, insertions, inversions and translocations, typically larger than 50 base pairs. This is the structural counterpart to single-nucleotide variant databases: search structural variants overlapping a gene (or by free text) and get each variant's dbVar accession, the study it came from, its type, the genes it overlaps, its genomic placement on GRCh38 and its clinical significance; then look up any variant for the full record — placements on both GRCh37 and GRCh38 assemblies, variant type, genes, clinical significance, study type, methods and variant counts. From BRCA1 CNVs to Cri-du-chat deletions, it is ideal for genomics, cytogenetics, rare-disease and bioinformatics work. A structural-variation / CNV resource — distinct from clinical single-nucleotide variant interpretation (ClinVar), population allele frequencies (gnomAD) and trait associations (GWAS). Open data from NCBI dbVar (public domain).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/dbvar-api","description":"oanor gateway"}],"tags":[{"name":"Structural Variants"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Structural Variants"],"summary":"Search structural variants by gene or text","description":"","parameters":[{"name":"gene","in":"query","required":false,"description":"Gene symbol","schema":{"type":"string"},"example":"BRCA1"},{"name":"q","in":"query","required":false,"description":"Free-text query (alternative to gene)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 20)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"query":"gene:BRCA1","total":2790,"variants":[{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7897183","placement":{"end":43094800,"start":43094800,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7897034","placement":{"end":43099831,"start":43099831,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7897014","placement":{"end":43094089,"start":43094089,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7896967","placement":{"end":43071123,"start":43071123,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["RPL21P4","BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7896545","placement":{"end":43078805,"start":43078805,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7896527","placement":{"end":43071198,"start":43071198,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7896349","placement":{"end":43092671,"start":43092671,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7896266","placement":{"end":43092945,"start":43092945,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7895607","placement":{"end":43064120,"start":43064120,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7895557","placement":{"end":43093496,"start":43093496,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7895471","placement":{"end":43092375,"start":43092375,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7895276","placement":{"end":43049438,"start":43049438,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7895119","placement":{"end":43093589,"start":43093589,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7894781","placement":{"end":43045355,"start":43045355,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7894710","placement":{"end":43093351,"start":43093351,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7894171","placement":{"end":43064144,"start":43064144,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["RPL21P4","BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7894011","placement":{"end":43078862,"start":43078862,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7893776","placement":{"end":43091021,"start":43091021,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7893765","placement":{"end":43076567,"start":43076567,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"},{"genes":["BRCA1"],"study":"nstd232","organism":"human","taxon_id":9606,"accession":"nsv7893462","placement":{"end":43092067,"start":43092067,"assembly":"GRCh38.p12","chromosome":"17"},"object_type":"VARIANT","variant_type":"insertion"}]},"meta":{"timestamp":"2026-06-01T23:40:59.781Z","request_id":"ddb179aa-d318-42a1-9bf3-7804525e83b3"},"status":"ok","message":"Variants retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/variant":{"get":{"operationId":"get_v1_variant","tags":["Structural Variants"],"summary":"A structural variant's full record","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"A dbVar accession (from /v1/search)","schema":{"type":"string"},"example":"nsv7897183"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"variant":{"uid":"57738222","url":"https://www.ncbi.nlm.nih.gov/dbvar/variants/nsv7897183/","genes":["BRCA1"],"study":"nstd232","methods":["Sequencing"],"organism":"human","taxon_id":9606,"accession":"nsv7897183","placement":{"end":43094800,"start":43094800,"assembly":"GRCh38.p12","chromosome":"17"},"placements":[{"end":41246817,"start":41246817,"assembly":"GRCh37","chromosome":"17"},{"end":43094800,"start":43094800,"assembly":"GRCh38.p12","chromosome":"17"}],"object_type":"VARIANT","variant_type":"insertion","variant_call_count":1}},"meta":{"timestamp":"2026-06-01T23:41:01.024Z","request_id":"f094f383-fdac-4e44-8654-9c51529cb61e"},"status":"ok","message":"Variant retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Endpoint catalogue & notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"dbVar is NCBI's archive of human genomic structural variation — structural variants (SVs) larger than ~50 bp: copy-number variants (CNVs), large deletions and duplications, insertions, inversions and translocations. /v1/search?gene=BRCA1 finds structural variants overlapping a gene (or use q= for free-text), returning each variant's dbVar accession (e.g. nsv7897183), the study it came from, variant type, organism, overlapping genes, GRCh38 genomic placement and clinical significance; /v1/variant?id=nsv7897183 returns a single variant's full record — placements on all assemblies (GRCh37 and GRCh38), variant type, genes, clinical significance, study type, methods and variant counts (you may also pass the numeric uid). Accessions look like nsv… (variant), nssv… (variant call) or nstd… (study). Data from NCBI dbVar (public domain). A structural-variation / CNV resource — distinct from clinical single-nucleotide variant interpretation (ClinVar), population allele frequencies (gnomAD) and trait associations (GWAS). Ideal for genomics, cytogenetics, rare-disease and bioinformatics tools.","source":"NCBI dbVar — database of genomic structural variation (ncbi.nlm.nih.gov/dbvar)","endpoints":["/v1/search","/v1/variant","/v1/meta"]},"meta":{"timestamp":"2026-06-01T23:41:01.124Z","request_id":"91116d99-5379-4d8e-94db-373ca2ae4cb1"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2280,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":645,"monthly_call_quota":45500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2100,"monthly_call_quota":228000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":5690,"monthly_call_quota":830000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/dbvar-api"}