api.ilepbase.com

Overview

The iLepBase REST API provides programmatic access to a comprehensive Lepidoptera (butterflies and moths) bioinformatics database. It supports queries for taxonomic classifications, genome assemblies, DNA barcodes, hostplant associations, morphology images, transcriptomes, literature, downloadable assets, proteins, BLAST search, MMNet species identification, and NicheBarcoding workflows.

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

• 50+ public endpoints covering taxonomy, datasets, omics, downloads, proteins, BLAST, MMNet, and NicheBarcoding
• 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
  }
}