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.


