Biospex API


Authentication

Every request needs an API token sent as a bearer token, plus an Accept header for JSON. Tokens for public project and expedition data carry the public:read ability. Contact us to request one.

curl -H "Authorization: Bearer YOUR_TOKEN" -H "Accept: application/json" https://api.biospex.org/v1/projects

Requests are rate limited per client; going over the limit returns HTTP 429.

Public projects and expeditions

Read-only. Only projects and expeditions shown on the public site are returned; anything else returns 404.

Endpoint Returns
GET /v1/projects Paginated list of public projects.
GET /v1/projects/{uuid} One project.
GET /v1/expeditions Paginated list of public expeditions.
GET /v1/expeditions/{uuid} One expedition.
Query parameters
  • per_page — results per page, 1 to 100 (default 25). Lists only.
  • page — page number. Lists only.
  • project_uuid — only expeditions belonging to this project.
  • status — active or completed expeditions; omit for both.
Response

Lists return the items in data, with links (first, last, prev, next) and meta (current_page, per_page, total) for paging. A single item is returned in data.

{
  "data": {
    "uuid": "…",
    "title": "…",
    "description": "…",
    "keywords": "…",
    "completed": false,
    "logo_url": "https://…",
    "project": { "uuid": "…", "title": "…" },
    "stats": { "transcriptions_completed": 1200, "transcriber_count": 85, "percent_completed": 40.5 },
    "created_at": "2026-01-15T14:02:11+00:00",
    "links": {
      "self": "https://api.biospex.org/v1/expeditions/UUID",
      "project": "https://api.biospex.org/v1/projects/UUID",
      "participate": "https://www.zooniverse.org/…"
    }
  }
}

Projects return uuid, title, slug, organization, organization_website, description_short, description_long, geographic_scope, taxonomic_scope, temporal_scope, keywords, logo_url, expeditions_count, transcriptions_completed, created_at and links (self, expeditions, page). An expedition's participate link is null unless it is currently live on Zooniverse.