{"uid":"cap_nSgyBhegEa26SN3ON07lx","slug":"ncbi-dbsnp-variant-lookup-by-rs-number-35aec478","name":"NCBI dbSNP Variant Lookup by rs Number","description":"NCBI dbSNP short variant record by rs number: variant type, placement (sequence and position), reference and alternate sequence, and study allele frequencies (e.g. 1000 Genomes allele counts). Up to 10 frequency rows per call.","url":"https://api.healthtravel-api.workers.dev/api/health/dbSNP-polymorphisms?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["rsid"],"properties":{"rsid":{"type":"string","description":"dbSNP rs number, e.g. rs429358"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"rsid":"rs429358","source":"https://www.ncbi.nlm.nih.gov/snp/rs429358","checkedAt":"2026-10-23T09:36:30.141Z","placement":{"position":44908683,"sequenceId":"NC_000019.10","alternateAllele":"T","referenceAllele":"T"},"frequencies":[{"study":"1000Genomes","sequence":"T","totalCount":5008,"alleleCount":4254},{"study":"1000Genomes_30X","sequence":"T","totalCount":6404,"alleleCount":5436}],"variantType":"snv"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6kdvJZRblJ-sOmFuPWOVB","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Retrieves a dbSNP short variant record by rs number, including variant type, genomic placement, reference/alternate alleles, and population allele frequencies from studies like 1000 Genomes.","exampleAgentPrompt":"Can you look up the dbSNP record for rs429358 and tell me its variant type, chromosomal position, reference and alternate alleles, and allele frequencies from the 1000 Genomes study?","exampleUseCases":[{"title":"APOE variant frequency research","prompt":"I need the allele frequency data for rs429358 — it's the APOE variant linked to Alzheimer's risk. Can you pull the dbSNP record and show me the 1000 Genomes allele counts?"},{"title":"Confirm SNP genomic coordinates","prompt":"What's the exact chromosomal position and sequence ID for rs7412 in dbSNP? I also need the reference and alternate alleles."},{"title":"Check variant type before analysis","prompt":"Before I run my pipeline, can you verify whether rs1801133 is classified as an SNV or something else in dbSNP, and give me the placement details?"}],"resultDescription":"Returns a JSON object containing the rsid, source URL, timestamp, placement details (chromosome position, sequence ID, reference allele, alternate allele), variant type (e.g. 'snv'), and up to 10 allele frequency rows from population studies (study name, allele sequence, total count, allele count).","failureModes":["Invalid or non-existent rsid returns an error or empty result","rsid without population frequency data returns an empty frequencies array","Network timeout if NCBI dbSNP upstream is slow","Malformed rsid (missing 'rs' prefix or non-numeric) may return a validation error","Only up to 10 frequency rows returned per call; large variant records may be truncated"],"whenToPreferThis":"Use this endpoint when you need structured, machine-readable dbSNP data for a specific rs number — particularly genomic placement coordinates and population allele frequencies — without scraping the NCBI website directly. It is ideal for bioinformatics pipelines, genetic risk assessment tools, or research agents needing to enrich variant data with frequency context. Prefer this over raw NCBI API calls when you need a clean JSON response with normalized frequency rows and do not need full annotation depth beyond 10 frequency entries.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:33:39.616Z","isFirstParty":false,"canonicalSlug":"ncbi-dbsnp-variant-lookup-by-rs-number-35aec478"}