# Genome Assemblies API
> Reference genome assemblies as an API — powered by NCBI Assembly, the registry of genome builds for organisms across the tree of life. Search assemblies by organism (or free text) and look up any assembly's metadata: its accession (GCF_… RefSeq or GCA_… GenBank), name (e.g. GRCh38.p14), organism and taxon id, assembly level (complete genome, chromosome, scaffold or contig), contiguity statistics (contig and scaffold N50), sequencing coverage, RefSeq category, UCSC and Ensembl names, the submitting organization, release date and FTP download paths. From the human reference genome to any sequenced microbe, plant or animal, it turns the genome-assembly registry into a clean search-and-fetch API. A genome-assembly registry — distinct from sequence (ENA), genome annotation (Ensembl), variant (ClinVar, dbVar) and gene-expression (GEO) databases. Open data from NCBI Assembly (public domain).

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/genomes-api/..."
```

## Pricing
- **Free** (Free) — 2,210 calls/Mo, 2 req/s
- **Starter** ($6/Mo) — 44,000 calls/Mo, 8 req/s
- **Pro** ($20/Mo) — 220,000 calls/Mo, 20 req/s
- **Mega** ($56/Mo) — 815,000 calls/Mo, 50 req/s

## Endpoints

### Genome Assemblies

#### `GET /v1/assembly` — A genome assembly's metadata

**Parameters:**
- `id` (query, optional, string) — Accession, name or uid (from /v1/search) Example: `GCF_000001405.40`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/genomes-api/v1/assembly?id=GCF_000001405.40"
```

#### `GET /v1/search` — Search genome assemblies

**Parameters:**
- `q` (query, optional, string) — Organism or free-text query Example: `Homo sapiens`
- `limit` (query, optional, string) — Max results (1-100, default 20)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/genomes-api/v1/search?q=Homo+sapiens"
```

### Meta

#### `GET /v1/meta` — Assembly levels & notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/genomes-api/v1/meta"
```


---
Marketplace page: https://www.oanor.com/api/genomes-api
OpenAPI spec: https://www.oanor.com/api/genomes-api/openapi.json