---
title: "Bulk download mutations as CSV"
method: GET
path: "/export/mutations.csv"
tags: ["Bulk Export"]
---

# Bulk download mutations as CSV

`GET /export/mutations.csv`

## Request

- Base URL: `https://canelib.erc.monash.edu/api`
- URL: `https://canelib.erc.monash.edu/api/export/mutations.csv`
- Auth: none declared

Stateless bulk mutation export — no session required. Accepts the same search filters as the /data/search page via GET query params. At least one filter is required to prevent full-table dumps. Returns up to 250,000 rows. Includes sample name, tissue, 9-mer epitopes, and external reference links.

## Query parameters

- `gene` string
- `tissue` string
- `cancer_type` string
- `cell_line` string
- `source` 'cosmic_CL' | 'cosmic_TS' | 'depMap' | 'pubMed'
- `mutation_type` string
- `histology` string
- `peptide` string
- `peptide_match` 'exact' | 'prefix' | 'contains' | 'suffix'
- `peptide_col` 'mutant' | 'wild'
- `project` 'CL' | 'TS'
- `q` string
- `min_samples` integer
- `min_cancer_types` integer
- `multi_source` '1'
- `limit` integer

## Response `200`

CSV file with mutation data.

## Other responses

- `400`: No filter provided, or query too broad.
- `404`: No matching mutations.
- `429`: Rate limit exceeded. You are sending too many requests. Limits: 5 requests/second, 120 requests/minute, 300 requests/10 minutes. Exceeding the 10-minute threshold blocks your IP for the remainder of that window.

---

[API](https://skmtc.dev/monash/apis/can-immune-api.md) · [All operations](https://skmtc.dev/monash/apis/can-immune-api/llms.txt) · [OpenAPI document](https://skmtc.dev/monash/apis/can-immune-api/revisions/df771ff27e97?raw)