Skip to content
GET /v1/chromosomes

An assembly chromosomes & sizes

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/ucsc-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/ucsc-api/v1/chromosomes" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/ucsc-api/v1/chromosomes", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/ucsc-api/v1/chromosomes");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/ucsc-api/v1/chromosomes",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "count": 200,
        "total": 711,
        "genome": "hg38",
        "chromosomes": [
            {
                "name": "chr1",
                "size_bp": 248956422
            },
            {
                "name": "chr2",
                "size_bp": 242193529
            },
            {
                "name": "chr3",
                "size_bp": 198295559
            },
            {
                "name": "chr4",
                "size_bp": 190214555
            },
            {
                "name": "chr5",
                "size_bp": 181538259
            },
            {
                "name": "chr6",
                "size_bp": 170805979
            },
            {
                "name": "chr7",
                "size_bp": 159345973
            },
            {
                "name": "chrX",
                "size_bp": 156040895
            },
            {
                "name": "chr8",
                "size_bp": 145138636
            },
            {
                "name": "chr9",
                "size_bp": 138394717
            },
            {
                "name": "chr11",
                "size_bp": 135086622
            },
            {
                "name": "chr10",
                "size_bp": 133797422
            },
            {
                "name": "chr12",
                "size_bp": 133275309
            },
            {
                "name": "chr13",
                "size_bp": 114364328
            },
            {
                "name": "chr14",
                "size_bp": 107043718
            },
            {
                "name": "chr15",
                "size_bp": 101991189
            },
            {
                "name": "chr16",
                "size_bp": 90338345
            },
            {
                "name": "chr17",
                "size_bp": 83257441
            },
            {
                "name": "chr18",
                "size_bp": 80373285
            },
            {
                "name": "chr20",
                "size_bp": 64444167
            },
            {
                "name": "chr19",
                "size_bp": 58617616
            },
            {
                "name": "chrY",
                "size_bp": 57227415
            },
            {
                "name": "chr22",
                "size_bp": 50818468
            },
            {
                "name": "chr21",
                "size_bp": 46709983
            },
            {
                "name": "chr8_KZ208915v1_fix",
                "size_bp": 6367528
            },
            {
                "name": "chr15_ML143371v1_fix",
                "size_bp": 5500449
            },
            {
                "name": "chr15_KI270905v1_alt",
                "size_bp": 5161414
            },
            {
                "name": "chr15_KN538374v1_fix",
                "size_bp": 4998962
            },
            {
                "name": "chr6_GL000256v2_alt",
                "size_bp
…