For Developers

Data access via API, JSON and CSV exports.

Data from Expeditia is made available under the Open Database License (ODbL). Individual contents are licensed under the Database Contents License (DbCL). Original data sources are Wikidata (CC0), GBIF (various), and Bionomia (CC0).

Note: responses are plain JSON, not JSON-LD. Semantic enrichment is planned for a future version.

CSV & JSON exports

Every expedition and person page has CSV and JSON download buttons. These export the full dataset without pagination.

Endpoint	Description
`/expedition/{qid}/export/csv`	All map items for an expedition as CSV
`/expedition/{qid}/export/json`	All map items for an expedition as JSON
`/person/{qid}/export/csv`	All specimens for a person as CSV
`/person/{qid}/export/json`	All specimens for a person as JSON

REST API

All API endpoints return JSON and do not require authentication.

Endpoint	Description
`GET /api/expeditions`	Paginated list of expeditions
`GET /api/expedition/{qid}`	Expedition metadata
`GET /api/expedition/{qid}/items`	All map items (points + specimens)
`GET /api/person/{qid}`	Person metadata
`GET /api/person/{qid}/specimens`	All specimens for a person

`GET /api/expedition/Q1564366/items`

Returns the full chronological list of itinerary points and specimens for the Second voyage of HMS Beagle.

{
  "expedition": {
    "wikidata_qid": "Q1564366",
    "label": "Second voyage of HMS Beagle",
    "description": "exploration associated with the theory of evolution (1831-1836)",
    "start_time": "1831-12-27",
    "end_time": "1836-10-02",
    "wikidata_url": "https://www.wikidata.org/wiki/Q1564366"
  },
  "items": [
    {
      "type": "point",
      "date_label": "1831-12-27",
      "name": "Plymouth",
      "lat": "50.3713889",
      "lon": "-4.1422222",
      "gbif_id": null,
      "scientific_name": null,
      ...
    },
    {
      "type": "specimen",
      "date_label": "1832-01-01",
      "name": "Suaeda",
      "lat": null,
      "lon": null,
      "gbif_id": "912674682",
      "scientific_name": "Suaeda",
      "family": "Amaranthaceae",
      "kingdom": "Plantae",
      "recorded_by": "Darwin, C.",
      "institution_code": "K",
      "collection_code": "Herbarium",
      "catalog_number": "K000899769",
      "basis_of_record": "PRESERVED_SPECIMEN",
      "type_status": "unknown type material",
      "locality": "Bahía Blanca; Coast of Patagonia",
      "country": "Argentina",
      "country_code": "AR",
      "event_date": "1832-01-01",
      "gbif_url": "https://www.gbif.org/occurrence/912674682"
    }
  ]
}

Item fields

Field	Type	Description
`type`	string	`point` or `specimen`
`date_label`	string	Date or date range as recorded
`name`	string	Place name (points) or scientific name (specimens)
`lat` / `lon`	decimal / null	Coordinates — may be null
`gbif_id`	integer / null	GBIF occurrence ID (specimens only)
`scientific_name`	string / null	Full scientific name (specimens only)
`family`	string / null	Taxonomic family
`kingdom`	string / null	Taxonomic kingdom
`recorded_by`	string / null	Collector name as recorded in GBIF
`identified_by`	string / null	Identifier name
`institution_code`	string / null	Holding institution
`collection_code`	string / null	Collection within institution
`catalog_number`	string / null	Catalogue number
`basis_of_record`	string / null	e.g. `PRESERVED_SPECIMEN`
`type_status`	string / null	Type status if applicable
`locality`	string / null	Locality as interpreted
`verbatim_locality`	string / null	Locality as originally recorded
`country`	string / null	Country name
`country_code`	string / null	ISO 3166-1 alpha-2
`event_date`	string / null	Collection date
`gbif_url`	string / null	Direct link to GBIF occurrence

← Back to About