General

Service index, health check, version metadata, database statistics, tools catalog, and service metadata.

`GET /api/v1`

API root. Returns the service name, version, and available public endpoints.

curl https://api.ilepbase.com/api/v1

Response

{
  "success": true,
  "data": {
    "name": "iLepBase API",
    "version": "v1",
    "endpoints": [
      "/api/v1/health",
      "/api/v1/version",
      "/api/v1/stats",
      "/api/v1/meta/summary",
      "/api/v1/search/suggestions",
      "/api/v1/taxonomy/tree/roots",
      "/api/v1/genomes",
      "/api/v1/barcodes",
      "/api/v1/hostplants",
      "/api/v1/morphology",
      "/api/v1/proteins",
      "/api/v1/downloads",
      "/api/v1/omics/transcriptomes",
      "/api/v1/omics/population-genomes",
      "/api/v1/tools",
      "/api/v1/blast/databases",
      "/api/v1/mmnet/health",
      "/api/v1/niche-barcoding/schemas"
    ]
  },
  "timestamp": "2026-04-23T12:00:00.000Z"
}

`GET /api/v1/health`

Health check endpoint. Returns service status and version.

curl https://api.ilepbase.com/api/v1/health

Response

{
  "success": true,
  "data": {
    "status": "ok",
    "service": "ilepbase-api",
    "version": "v1"
  },
  "timestamp": "2026-04-23T12:00:00.000Z"
}

`GET /api/v1/version`

Returns API version and build metadata.

curl https://api.ilepbase.com/api/v1/version

`GET /api/v1/stats`

Database-wide statistics, including record counts by data domain and last update time.

curl https://api.ilepbase.com/api/v1/stats

`GET /api/v1/meta/summary`

Aggregate public statistics across data domains.

curl https://api.ilepbase.com/api/v1/meta/summary

Response

{
  "success": true,
  "data": {
    "families": 126,
    "species": 114852,
    "barcodes": 48200,
    "dataDomains": 8,
    "updatedAt": "2026-04-20T08:00:00.000Z"
  },
  "timestamp": "2026-04-23T12:00:00.000Z"
}

Field	Type	Description
`families`	`int`	Number of Lepidoptera families in the database.
`species`	`int`	Total species records.
`barcodes`	`int`	Total DNA barcode entries.
`dataDomains`	`int`	Number of active data modules.
`updatedAt`	`string`	ISO 8601 timestamp of the last data update.

`GET /api/v1/tools`

Lists analysis tools linked to the platform. See the Tools page for the full response schema.

curl https://api.ilepbase.com/api/v1/tools

`GET /api/v1/about`

Returns service version, build metadata, record counts, and last update time.

curl https://api.ilepbase.com/api/v1/about

Response fields

Field	Type	Description
`version`	`string`	API / service version.
`gitCommit`	`string`	Build revision identifier.
`speciesCount`	`int`	Total species in the database.
`genomeCount`	`int`	Total genome assemblies.
`updatedAt`	`string`	ISO 8601 last data update.

`GET /swagger/index.html`

Interactive Swagger UI for the API. Served at the service root (outside /api/v1).

curl https://api.ilepbase.com/swagger/index.html

`GET /metrics`

Prometheus metrics endpoint. Only available when metrics collection is enabled on the server.

curl https://api.ilepbase.com/metrics

General

On this page