api.ilepbase.com

Overview

The iLepBase REST API provides programmatic access to a comprehensive Lepidoptera (butterflies and moths) bioinformatics database. Data modules follow the current frontend order: Taxonomy, Genome, Transcriptome, Protein Structure, Barcode, Distribution, Host Plant, and Literature; downloads, tools, and analysis workflow endpoints remain documented.

Base URL: https://api.ilepbase.com/api/v1

All endpoints return JSON unless noted otherwise. This reference documents public API endpoints that require no authentication.

Synced from Postman collection iLepBase API. Auth, Admin, and internal Jobs endpoints are not included.

Key Features

• Public endpoints organized by current data modules covering taxonomy, genome, transcriptome, protein structure, barcode, distribution, host plant, and literature
• Consistent JSON response envelope
• Pagination with page / pageSize query parameters
• Full-text and typeahead search on taxonomy and global search
• Lazy-loading taxonomy tree (/tree/roots, /tree/children)

Data Domains

Response Envelope

Every response follows this structure:

{
  "success": true,
  "data": { ... },
  "timestamp": "2026-04-23T12:00:00.000Z"
}

Errors return "success": false with an error object:

{
  "success": false,
  "error": {
    "code": "PROTEIN_NOT_FOUND",
    "message": "Protein record does not exist."
  },
  "timestamp": "2026-04-23T12:00:00.000Z"
}

Paginated responses include a pagination object:

{
  "pagination": {
    "page": 1,
    "pageSize": 10,
    "total": 48200,
    "totalPages": 4820,
    "hasNext": true,
    "hasPrev": false
  }
}