Lumminary API

lumminary · Data

Data No Auth Free & Open open_data

# Introduction The Lumminary API was built to allow third parties to interact with Lumminary customers and gain access to their genetic data. The Lumminary API is fast, scalable and highly secure. All requests to the Lumminary API take place over SSL, which means all communication of Customer data is encrypted. Before we dive in, some definitions. This is what we mean by: |Term|Definition| |-----------|-----------| |**Third party**|A third party (also referred to as "partner" or as "you") is a

Authentication

No authentication requiredFree to use with no key needed.

Sample Requests

GET Reference genome builds

Lists reference genome builds that are available

https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/genomes

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/genomes/"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/genomes/",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/genomes/';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/genomes/"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/genomes/")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/genomes/";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Reference SNP data

Get reference SNP information, from dbSNP

https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/snps/{snpAccession}?grch_version=GRCH37P13&dbsnp_version=149

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/snps/{snpAccession}?grch_version=GRCH37P13&dbsnp_version=149"

import requests
params = {
    "grch_version": "GRCH37P13",
    "dbsnp_version": "149"
}
response = requests.get(
    "https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/snps/{snpAccession}",
    params=params,
)
print(response.json())

const url = new URL('https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/snps/{snpAccession}');
url.searchParams.set('grch_version', 'GRCH37P13');
url.searchParams.set('dbsnp_version', '149');

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
	"net/url"
)

func main() {
	baseURL, _ := url.Parse("https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/snps/{snpAccession}")
	q := baseURL.Query()
	q.Set("grch_version", "GRCH37P13")
	q.Set("dbsnp_version", "149")
	baseURL.RawQuery = q.Encode()
	targetURL := baseURL.String()
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/snps/{snpAccession}")
uri.query = URI.encode_www_form({
  "grch_version" => "GRCH37P13",
  "dbsnp_version" => "149"
})

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/lumminary.com/1.0/reference/snps/{snpAccession}?" . http_build_query([
    "grch_version" => "GRCH37P13",
    "dbsnp_version" => "149"
]);
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

GET Get product details

Get product details

https://api.apis.guru/v2/specs/lumminary.com/1.0/products/{productId}

Hover any highlighted part to learn what it does

curl -X GET "https://api.apis.guru/v2/specs/lumminary.com/1.0/products/{productId}"

import requests
response = requests.get(
    "https://api.apis.guru/v2/specs/lumminary.com/1.0/products/{productId}",
)
print(response.json())

const url = 'https://api.apis.guru/v2/specs/lumminary.com/1.0/products/{productId}';

const response = await fetch(url); 
const data = await response.json();
console.log(data);

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	targetURL := "https://api.apis.guru/v2/specs/lumminary.com/1.0/products/{productId}"
	req, _ := http.NewRequest("GET", targetURL, nil)

	client := &http.Client{}
	resp, _ := client.Do(req)
	defer resp.Body.Close()
	body, _ := io.ReadAll(resp.Body)
	fmt.Println(string(body))
}

require "net/http"
require "json"

uri = URI("https://api.apis.guru/v2/specs/lumminary.com/1.0/products/{productId}")

http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == "https"

req = Net::HTTP::Get.new(uri)

res = http.request(req)
puts JSON.parse(res.body)

<?php
$url = "https://api.apis.guru/v2/specs/lumminary.com/1.0/products/{productId}";
$opts = ["http" => [
    "method" => "GET",
]];
$ctx = stream_context_create($opts);
$res = file_get_contents($url, false, $ctx);
print_r(json_decode($res, true));

Postman Setup Guide

Get Postman ↗

See official documentation for authentication and setup.

What can you build with Lumminary API?

Lumminary API is a Data API. Developers commonly use data APIs for:

enriching your app with third-party datasets
building data pipelines and ETL workflows
querying and searching large datasets
powering research, analysis, and reporting tools
syncing reference data into your own systems

No authentication required. This API is open — no signup or key needed. Ideal for quick prototypes and public-facing features. Lumminary API is free to use, making it a low-risk choice to experiment with.

New to APIs? Read our beginner's guide · Learn about API keys · What is REST?

Open documentation ↗