API overview

The TReXome DB API provides public read-only access to tandem repeat domain data, including repeat-level records, exon associations, transcript identifiers, and protein-level summaries. It is intended for integration into external analysis tools, pipelines, and visualisation platforms.

Available endpoints

GET /api/repeats
Returns one row per repeat–exon match, including flattened repeat and exon fields together with the original source object.

GET /api/proteins
Returns one row per protein, aggregating repeat counts, transcript IDs, exon IDs, exon numbers, and summary properties.

GET /docs
Interactive OpenAPI documentation for exploring parameters and testing requests.

Common filters
Endpoint Parameter Description
/api/repeats gene Filter by gene symbol.
/api/repeats uniprot_id Filter by UniProt accession.
/api/repeats transcript_id Filter by Ensembl transcript ID.
/api/repeats exon_id Filter by Ensembl exon ID.
/api/repeats exon_number Filter by exon number.
/api/repeats chrom, start, end Query repeats overlapping a genomic region.
/api/repeats single_repeat_exon Restrict to exons that are in-frame, fully coding, and contain exactly one repeat.
/api/repeats and /api/proteins page, page_size Pagination parameters. Maximum page size is 200.
/api/proteins gene, uniprot_id, repeat_type, status, eligibility Protein-level filters.
Example requests

All repeats for one gene
GET https://tandem-repeat-domain-database.onrender.com/api/repeats?gene=KLHL17

Filter by exon ID
GET https://tandem-repeat-domain-database.onrender.com/api/repeats?exon_id=ENSE00001365077

Filter by genomic interval
GET https://tandem-repeat-domain-database.onrender.com/api/repeats?chrom=chr1&start=963000&end=964000

Single-repeat candidate exons
GET https://tandem-repeat-domain-database.onrender.com/api/repeats?single_repeat_exon=true

Protein-level summary
GET https://tandem-repeat-domain-database.onrender.com/api/proteins?gene=KLHL17

Paginated query
GET https://tandem-repeat-domain-database.onrender.com/api/repeats?page=1&page_size=50

Response format

Responses are paginated and follow this general structure:

{
  "page": 1,
  "page_size": 50,
  "total_results": 124,
  "total_pages": 3,
  "results": [
    {
      "gene": "KLHL17",
      "uniprot_id": "Q6TDP4",
      "repeat_type": "Kelch"
    }
  ]
}

The API is public and read-only. Repeat-level results include flattened fields for easy downstream use, as well as the original nested source object for full context.

Suggested use cases

Tool integration, variant interpretation workflows, candidate exon prioritisation, custom visualisation, and downstream data reuse.