GET data
66 minute read
- The OpenDataBio-R package is a client for this API.
- Query examples in R are here;
- No authentication is needed to access data with a public access policy
- Authentication token is required only to get data with a non-public access policy
Shared GET parameters
When multiple parameters are specified, they are combined with an AND operator. There is no OR parameter option in searches.
The limit and offset parameters can be used to divide your search into parts. Alternatively, use the save_job=T option and then download the data with the get_file=T parameter from the userjobs API.
Some parameters accept an asterisk as wildcard, so api/v0/taxons?name=Euterpe will return taxons with name exactly as “Euterpe”, while api/v0/taxons?name=Eut* will return names starting with “Eut”.
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
limit | No | Maximum number of records to return. | 100 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
Selecting response fields
The fields parameter controls the returned columns:
simpleis the default profile and contains the fields most useful for common workflows;alladds detailed, relational, technical, or compatibility fields;- a comma-separated list, such as
fields=id,uuid,scientificName, returns only the requested fields.
Each endpoint below includes a table showing membership in simple and all
and the meaning of every field. Definitions come from the application schema.
Endpoint-specific meanings take precedence over shared definitions—for example,
x and y mean different things for Locations and Individuals. Fields marked
as Darwin Core follow the exchange vocabulary; fields marked as local are
OpenDataBio extensions.
GET endpoints
Quick links
- /
- bibreferences
- biocollections
- datasets
- individuals
- individual-locations
- languages
- locations
- measurements
- media
- persons
- projects
- taxons
- traits
- vernaculars
- vouchers
- userjobs
- activities
- tags
- brahms
- identification-histories
/ (GET)
Tests your access/token.
No parameters for this endpoint.
bibreferences (GET)
Bibliographic references (GET lists, POST creates).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
bibkey | No | Bibreference key or list of keys. | ducke1953,mayr1992 |
biocollection | No | Biocollection id/name/acronym; returns references cited by vouchers in those collections. | INPA |
dataset | No | Dataset id or name; returns bibreferences linked to the dataset. | Forest1 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
limit | No | Maximum number of records to return. | 100 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
search | No | Full-text search on bibtex using boolean mode; spaces act as AND. | Amazon forest |
taxon | No | Taxon id or canonical name list; matches references linked to the taxon. | Ocotea guianensis or 120,455 |
taxon_root | No | Taxon id/name including descendants. | Lauraceae |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
bibkey | simple / all | OpenDataBio local short key used to identify a bibliographic reference. |
year | simple / all | Publication year of a bibliographic reference. |
author | simple / all | Author string for a bibliographic reference or taxonomic name, depending on the endpoint. |
title | simple / all | Title of a bibliographic reference or dataset, depending on the endpoint. |
doi | simple / all | Digital Object Identifier associated with a bibliographic reference. |
url | simple / all | URL associated with a bibliographic reference. |
bibtex | simple / all | BibTeX representation of the bibliographic reference or media citation. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 2,
"bibkey": "Riberiroetal1999FloraDucke",
"year": 1999,
"author": "José Eduardo Lahoz Da Silva Ribeiro and Michael John Gilbert Hopkins and Alberto Vicentini and Cynthia Anne Sothers and Maria Auxiliadora Da Silva Costa and Joneide Mouzinho De Brito and Maria Anália Duarte De Souza and Lúcia Helena Pinheiro Martins and Lúcia Garcez Lohmann and Paulo Apóstolo Costa Lima Assunção and Everaldo Da Costa Pereira and Cosme Fernandes Da Silva and Mariana Rabello Mesquita and Lilian Costa Procópio",
"title": "Flora Da Reserva Ducke: Guia De Identificação Das Plantas Vasculares De Uma Floresta De Terra Firme Na Amazônica Central",
"doi": null,
"url": null,
"bibtex": "@Article{Riberiroetal1999FloraDucke,\r\n title = {Flora da Reserva Ducke: Guia de Identifica{\\c{c}}{\\~a}o das Plantas Vasculares de uma Floresta de Terra Firme na Amaz{\\^o}nica Central},\r\n author = {José Eduardo Lahoz da Silva Ribeiro and Michael John Gilbert Hopkins and Alberto Vicentini and Cynthia Anne Sothers and Maria Auxiliadora da Silva Costa and Joneide Mouzinho de Brito and Maria Anália Duarte de Souza and Lúcia Helena Pinheiro Martins and Lúcia Garcez Lohmann and Paulo Apóstolo Costa Lima Assunç{ã}o and Everaldo da Costa Pereira and Cosme Fernandes da Silva and Mariana Rabello Mesquita and Lilian Costa Procópio},\r\n journal = {Flora da Reserva Ducke: Guia de Identifica{\\c{c}}{\\~a}o das Plantas Vasculares de uma Floresta de Terra Firme na Amaz{\\^o}nica Central},\r\n year = {1999},\r\n publisher = {INPA-DFID Manaus},\r\n pages = {819p},\r\n}"
},
{
"id": 3,
"bibkey": "Sutter2006female",
"year": 2006,
"author": "D. Merino Sutter and P. I. Forster and P. K. Endress",
"title": "Female Flowers And Systematic Position Of Picrodendraceae (Euphorbiaceae S.l., Malpighiales)",
"doi": "10.1007/s00606-006-0414-0",
"url": "http://dx.doi.org/10.1007/s00606-006-0414-0",
"bibtex": "@article{Sutter2006female,\n author = {D. Merino Sutter and P. I. Forster and P. K. Endress},\n year = {2006},\n title = {Female flowers and systematic position of Picrodendraceae (Euphorbiaceae s.l., Malpighiales)},\n issn = {0378-2697 | 1615-6110},\n issue = {1-4},\n url = {http://dx.doi.org/10.1007/s00606-006-0414-0},\n doi = {10.1007/s00606-006-0414-0},\n volume = {261},\n page = {187-215},\n journal = {Plant Systematics and Evolution},\n journal_short = {Plant Syst. Evol.},\n published = {Springer Science and Business Media LLC}\n}"
}
]
}biocollections (GET)
Biocollections (GET lists, POST creates).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
acronym | No | Biocollection acronym. | INPA |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
irn | No | Index Herbariorum IRN for filtering biocollections. | 123456 |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
limit | No | Maximum number of records to return. | 100 |
name | No | Exact biocollection name (string). | Instituto Nacional de Pesquisas da Amazônia |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
search | No | Full-text search parameter. | Silva |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
acronym | simple / all | OpenDataBio local acronym for a project or biocollection. |
name | simple / all | OpenDataBio local name of the exported resource. |
irn | simple / all | OpenDataBio local institutional registration number for a biological collection. |
country | all | Country name or code associated with a location. |
city | all | OpenDataBio local city recorded for a biological collection. |
address | all | OpenDataBio local address text recorded for a biocollection. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 1,
"acronym": "INPA",
"name": "Instituto Nacional de Pesquisas da Amazônia",
"irn": 124921,
"country": null,
"city": null,
"address": null
},
{
"id": 2,
"acronym": "SPB",
"name": "Universidade de São Paulo",
"irn": 126324,
"country": null,
"city": null,
"address": null
}
]
}datasets (GET)
Datasets and published dataset versions (GET lists, POST creates via import job).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
bibreference | No | Bibreference id or bibkey. | 34 or ducke1953 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
has_versions | No | When 1, returns only datasets that have public versions. | 1 |
include_url | No | When 1 with list_versions, include archive URL. | 1 |
limit | No | Maximum number of records to return. | 100 |
list_versions | No | If true, lists dataset version files for given id(s). | 1 |
name | No | Translatable trait name. Accepts a plain string or a JSON map of language codes to names. | {"en":"Height","pt-br":"Altura"} |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
project | No | Project id or acronym. | PDBFF or 2 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
search | No | Full-text search parameter. | Silva |
summarize | No | Dataset id to return content/taxonomic/trait summaries. | 3 |
tag | No | Individual tag/number/code. | A-1234 |
tagged_with | No | Tag ids (comma) or text to filter datasets by tags (supports id list or full-text). | 12,13 or canopy leaf |
taxon | No | Taxon id or canonical full name list. | Licaria cannela or 456,789 |
taxon_root | No | Taxon id/name including descendants. | Lauraceae |
traits | No | Trait ids list (comma-separated) for filtering datasets. | 12,15 |
version_id | No | Dataset version id to list or download. | 34 |
version_uuid | No | Dataset version UUID to list or download. | 550e8400-e29b-41d4-a716-446655440000 |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
name | simple / all | OpenDataBio local name of the exported resource. |
title | simple / all | Title of a bibliographic reference or dataset, depending on the endpoint. |
projectName | simple / all | Name or acronym of the project linked to the record or dataset. |
project_id | simple / all | Internal numeric identifier of the project linked to the record or dataset. |
project_uuid | simple / all | Stable UUID of the project linked to the record or dataset. |
description | simple / all | OpenDataBio local descriptive text for the exported resource. |
notes | simple / all | OpenDataBio local notes associated with the exported resource. |
contactEmail | simple / all | OpenDataBio local contact email configured for the dataset. |
taggedWidth | simple / all | OpenDataBio local list of tags associated with a dataset. This legacy field name is kept for API compatibility. |
policyCode | simple / all | Compact policy code derived from the dataset license and data-use obligations. |
privacyLevel | all | OpenDataBio local system access level configured for the dataset; this is not a license. |
policy | all | OpenDataBio local full data policy text stored for a dataset. |
measurements_count | all | OpenDataBio local count of measurements linked to the dataset. |
policyUrl | all | URL where the full dataset policy can be read for the governing dataset or version. |
policySummary | all | Short plain-language summary of the data-use permissions and obligations. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 4,
"name": "PDBFF-FITO 1ha core plots 1-10cm dbh - TREELETS",
"title": "Arvoretas (1cm>DAP",
"projectName": "Projeto Dinâmica Biológica de Fragmentos Florestais (PDBFF-Data)",
"notes": null,
"privacyLevel": "Restrito a usuários autorizados",
"policy": null,
"description": "Contém o único censo de árvores de pequeno porte 1-10cm de diâmetro nas parcelas de 1ha do PDBFF, em 11 das 69 de parcelas permanentes de 1ha do Programa de Monitoramento de Plantas do PDBFF.",
"measurements_count": null,
"contactEmail": "example",
"taggedWidth": "Parcelas florestais | PDBFF | Fitodemográfico",
"uuid": "e1d8ce8d-4847-11f0-8e9f-9cb654b86224"
}
]
}individuals (GET)
Individuals (GET lists, POST creates, PUT updates).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
dataset | No | Dataset id/name, filter records that belong to the dataset informed | 3 or FOREST1 |
date_max | No | Inclusive end date (YYYY-MM-DD) compared against individual date. | 2024-12-31 |
date_min | No | Inclusive start date (YYYY-MM-DD) compared against individual date. | 2020-01-01 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
limit | No | Maximum number of records to return. | 100 |
location | No | Location id/name list; matches individuals at those exact locations. | Parcela 25ha or 55,60 |
location_root | No | Location id/name; includes descendants of the informed locations. | Parcela 25ha get subplots in this case |
odbrequest_id | No | Request id to filter individuals linked to that ODB request. | 12 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
person | No | Collector person id/name/email list; filters main/associated collectors. | Silva, J.B. or 23,10 |
project | No | Project id/name; matches records whose dataset belongs to the project. | PDBFF |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
tag | No | Individual tag/number filter; supports list separated by comma. | A-123,2001 |
taxon | No | Taxon id/name list; matches identification taxon only (no descendants). | Licaria guianensis,Minquartia guianensis or 456,457 |
taxon_root | No | Taxon id/name list; includes descendants of each taxon. | Lauraceae,Fabaceae or 10,20 |
trait | No | Trait id list; only used together with dataset to filter by measurements. | 12,15 |
vernacular | No | Vernacular id/name list to match linked vernaculars. | castanha|12 |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
dataset_id | simple / all | Internal numeric identifier of the dataset that governs the exported record. |
basisOfRecord | simple / all | Darwin Core column: basisOfRecord value indicating the general type of biological record. |
organismID | simple / all | Darwin Core column: stable identifier of the organism/individual, formatted by OpenDataBio as odb:{installation}:individual:{uuid}. |
organismName | simple / all | Darwin Core column: human-readable label for the organism or individual record. |
recordedByMain | simple / all | Main collector or observer responsible for the record. |
recordNumber | simple / all | Darwin Core column: collector or observer record number. |
eventDate | simple / all | Darwin Core column: date or interval during which the collection, observation, media capture, or occurrence event took place. |
family | simple / all | Darwin Core taxonomic column: family associated with the exported taxon or identified organism. |
scientificName | simple / all | Darwin Core taxonomic column: scientific name associated with the record at the time of export. |
identificationQualifier | simple / all | Darwin Core column: qualifier expressing uncertainty or qualification of the identification. |
identifiedBy | simple / all | Darwin Core column: person or people responsible for the taxonomic identification. |
dateIdentified | simple / all | Darwin Core column: date when the taxonomic identification was made. |
locationName | simple / all | Darwin Core-compatible location label used by OpenDataBio for the location associated with the record. |
locationParentName | simple / all | Name of the parent location that contains the record location. |
higherGeography | simple / all | Darwin Core column: higher geographic context for the location, such as parent locations or administrative hierarchy. |
decimalLatitude | simple / all | Darwin Core column: latitude in decimal degrees, when coordinates are available for distribution. |
decimalLongitude | simple / all | Darwin Core column: longitude in decimal degrees, when coordinates are available for distribution. |
x | simple / all | OpenDataBio local field for occurrence position: Cartesian X coordinate of the individual within its plot, transect, or parent location. |
y | simple / all | OpenDataBio local field for occurrence position: Cartesian Y coordinate of the individual within its plot, transect, or parent location. In transects, sign may indicate side of the transect. |
gx | simple / all | OpenDataBio local projected or grid X coordinate for an individual position when available. |
gy | simple / all | OpenDataBio local projected or grid Y coordinate for an individual position when available. |
angle | simple / all | OpenDataBio local azimuth in degrees from a reference point to an occurrence position. |
distance | simple / all | OpenDataBio local distance in meters from a reference point to an occurrence position. |
datasetID | simple / all | Darwin Core column: stable identifier of the dataset governing the record, formatted by OpenDataBio as odb:{installation}:dataset:{uuid}; includes the dataset UUID and installation prefixes. |
datasetName | simple / all | Darwin Core column: name or title of the dataset governing the exported record. |
accessRights | simple / all | Darwin Core column: human-readable information about permissions, restrictions, and conditions for using the record, derived from the license and data policy of the dataset governing the record. |
policyCode | simple / all | Compact policy code derived from the dataset license and data-use obligations. |
recordedDate | all | OpenDataBio legacy column equivalent to Darwin Core eventDate. Kept in all exports for backward compatibility; prefer eventDate for interoperability. |
recordedBy | all | Darwin Core column: collectors or observers associated with the record. |
scientificNameAuthorship | all | Darwin Core taxonomic column: authorship string associated with the scientific name. |
taxon_id | all | Internal numeric identifier of the linked taxonomic name. |
taxon_uuid | all | Stable UUID of the linked taxonomic name. |
identification_id | all | Internal numeric identifier of the taxonomic identification linked to the record. |
identification_uuid | all | Stable UUID of the taxonomic identification linked to the record. |
taxonPublishedStatus | all | Publication status of the taxonomic name used in the identification. |
genus | all | Darwin Core taxonomic column: genus associated with the exported taxon or identified organism. |
identificationRemarks | all | Darwin Core column: notes associated with the taxonomic identification. |
identificationBiocollection | all | Biocollection used as a reference for the identification, when applicable. |
identificationBiocollectionReference | all | Catalog or reference number in the biocollection used for identification. |
location_id | all | Internal numeric identifier of the linked location. |
location_uuid | all | Stable UUID of the linked location. |
georeferenceRemarks | all | Darwin Core column: notes describing coordinate origin, uncertainty, georeferencing or location details. |
relatedLocations | all | Other locations related to the record that may not fit political administrative boundaries, such as Indigeneous Territories, Protected areas and environmental layers stored in the Opendatabio installation |
organismRemarks | all | Darwin Core column: remarks about the organism or individual. |
policyUrl | all | URL where the full dataset policy can be read for the governing dataset or version. |
policySummary | all | Short plain-language summary of the data-use permissions and obligations. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 306246,
"basisOfRecord": "Organism",
"organismID": "2639_Spruce_1852",
"recordedByMain": "Spruce, R.",
"recordNumber": "2639",
"recordedDate": "1852-10",
"recordedBy": "Spruce, R.",
"scientificName": "Ecclinusa lanceolata",
"scientificNameAuthorship": "(Mart. & Eichler) Pierre",
"taxonPublishedStatus": "published",
"genus": "Ecclinusa",
"family": "Sapotaceae",
"identificationQualifier": "",
"identifiedBy": "Spruce, R.",
"dateIdentified": "1852-10-00",
"identificationRemarks": "",
"identificationBiocollection": null,
"identificationBiocollectionReference": null,
"locationName": "São Gabriel da Cachoeira",
"higherGeography": "São Gabriel da Cachoeira < Amazonas < Brasil",
"decimalLatitude": 1.1841927,
"decimalLongitude": -66.80167715,
"georeferenceRemarks": "decimal coordinates are the CENTROID of the footprintWKT geometry",
"locationParentName": "Amazonas",
"x": null,
"y": null,
"gx": null,
"gy": null,
"angle": null,
"distance": null,
"organismRemarks": "prope Panure ad Rio Vaupes Amazonas, Brazil",
"datasetName": "Exsicatas LABOTAM",
"uuid": "c01000f0-f437-11ef-b90b-9cb654b86224"
}
]
}individual-locations (GET)
Occurrences for individuals with multiple locations (GET lists, POST/PUT upserts).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
dataset | No | Dataset id/name; filters by dataset of the linked individual. | FOREST1 |
date_max | No | Upper bound date/time; compares date_time or individual date when empty. | 2024-12-31 |
date_min | No | Lower bound date/time; compares date_time or individual date when empty. | 2020-01-01 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
individual | No | Individual id list whose occurrences will be returned. | 12,44 |
limit | No | Maximum number of records to return. | 100 |
location | No | Location id or name. | Parcela 25ha or 55 |
location_root | No | Location id/name with descendants included. | Amazonas or 10 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
person | No | Collector person id/name/email list; filters by individual collectors. | J.Silva|23 |
project | No | Project id/name; matches occurrences whose individual belongs to datasets in project. | PDBFF |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
tag | No | Individual tag/number list; matches by individuals.tag column | A-123,B-2 |
taxon | No | Taxon id or canonical full name list. | Licaria cannela or 456,789 |
taxon_root | No | Taxon id/name including descendants. | Lauraceae |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
individual_id | simple / all | Internal numeric identifier of the linked individual or organism record. |
individual_uuid | simple / all | Stable UUID of the linked individual or organism record. |
location_id | simple / all | Internal numeric identifier of the linked location. |
location_uuid | simple / all | Stable UUID of the linked location. |
basisOfRecord | simple / all | Darwin Core column: basisOfRecord value indicating the general type of biological record. |
occurrenceID | simple / all | Darwin Core column: stable identifier of the biological occurrence record. In OpenDataBio, an occurrence should represent the presence/record of an organism or taxon at a location. |
organismID | simple / all | Darwin Core column: stable identifier of the organism/individual, formatted by OpenDataBio as odb:{installation}:individual:{uuid}. |
organismName | simple / all | Darwin Core column: human-readable label for the organism or individual record. |
eventDate | simple / all | Darwin Core column: date or interval during which the collection, observation, media capture, or occurrence event took place. |
locationName | simple / all | Darwin Core-compatible location label used by OpenDataBio for the location associated with the record. |
higherGeography | simple / all | Darwin Core column: higher geographic context for the location, such as parent locations or administrative hierarchy. |
decimalLatitude | simple / all | Darwin Core column: latitude in decimal degrees, when coordinates are available for distribution. |
decimalLongitude | simple / all | Darwin Core column: longitude in decimal degrees, when coordinates are available for distribution. |
x | simple / all | OpenDataBio local field for occurrence position: Cartesian X coordinate of this individual occurrence within its plot, transect, or parent location. |
y | simple / all | OpenDataBio local field for occurrence position: Cartesian Y coordinate of this individual occurrence within its plot, transect, or parent location. In transects, sign may indicate side of the transect. |
angle | simple / all | OpenDataBio local azimuth in degrees from a reference point to an occurrence position. |
distance | simple / all | OpenDataBio local distance in meters from a reference point to an occurrence position. |
minimumElevation | simple / all | Darwin Core column: lower bound of elevation for the occurrence or location, in meters. |
occurrenceRemarks | simple / all | Darwin Core column: remarks about the occurrence. |
scientificName | simple / all | Darwin Core taxonomic column: scientific name associated with the record at the time of export. |
family | simple / all | Darwin Core taxonomic column: family associated with the exported taxon or identified organism. |
datasetID | simple / all | Darwin Core column: stable identifier of the dataset governing the record, formatted by OpenDataBio as odb:{installation}:dataset:{uuid}; includes the dataset UUID and installation prefixes. |
datasetName | simple / all | Darwin Core column: name or title of the dataset governing the exported record. |
accessRights | simple / all | Darwin Core column: human-readable information about permissions, restrictions, and conditions for using the record, derived from the license and data policy of the dataset governing the record. |
policyCode | simple / all | Compact policy code derived from the dataset license and data-use obligations. |
occurrenceName | all | Human-readable label for an occurrence record. |
recordedDate | all | OpenDataBio legacy column equivalent to Darwin Core eventDate. Kept in all exports for backward compatibility; prefer eventDate for interoperability. |
georeferenceRemarks | all | Darwin Core column: notes describing coordinate origin, uncertainty, georeferencing or location details. |
organismRemarks | all | Darwin Core column: remarks about the organism or individual. |
policyUrl | all | URL where the full dataset policy can be read for the governing dataset or version. |
policySummary | all | Short plain-language summary of the data-use permissions and obligations. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 306244,
"individual_id": 306246,
"basisOfRecord": "Occurrence",
"occurrenceID": "2639_Spruce_1852.1852-10",
"organismID": "2639_Spruce_1852",
"scientificName": "Ecclinusa lanceolata",
"family": "Sapotaceae",
"recordedDate": "1852-10",
"locationName": "São Gabriel da Cachoeira",
"higherGeography": "Brasil > Amazonas > São Gabriel da Cachoeira",
"decimalLatitude": 1.1841927,
"decimalLongitude": -66.80167715,
"georeferenceRemarks": "decimal coordinates are the CENTROID of the footprintWKT geometry",
"x": null,
"y": null,
"angle": null,
"distance": null,
"minimumElevation": null,
"occurrenceRemarks": null,
"organismRemarks": "prope Panure ad Rio Vaupes Amazonas, Brazil",
"datasetName": "Exsicatas LABOTAM"
}
]
}languages (GET)
Lists available interface/data languages.
| Parameter | Required | Description | Example |
|---|---|---|---|
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
limit | No | Maximum number of records to return. | 100 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 1,
"code": "en",
"name": "English",
"is_locale": 1,
"created_at": null,
"updated_at": null
}
]
}locations (GET)
Locations (GET lists, POST creates, PUT updates).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
adm_level | No | One or more adm_level codes | 10,100 |
dataset | No | Dataset id/name; expands to all locations used by that dataset. | FOREST1 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
lat | No | Latitude (decimal degrees) used with querytype. | -3.11 |
limit | No | Maximum number of records to return. | 100 |
location_root | No | Alias of root for compatibility. | Amazonas |
long | No | Longitude (decimal degrees) used with querytype. | -60.02 |
name | No | Exact name match; accepts list of names or ids. | Manaus or 10 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
parent_id | No | Parent id for hierarchical queries. | 210 |
project | No | Project id or acronym. | PDBFF or 2 |
querytype | No | When lat/long are provided: exact|parent|closest geometric search. | parent |
root | No | Location id/name; returns it and all descendants and related locations | Amazonas or "Parque Nacional do Jaú" ... |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
search | No | Prefix search on name (SQL LIKE name%). | Mana search for names that starts "mana" |
taxon | No | Taxon id/name list; filters locations by linked identifications. | Euterpe precatoria |
taxon_root | No | Taxon id/name list; includes descendants when filtering linked identifications. | Euterpe - finds alls records that belongs to this genus |
trait | No | Trait id/name; only works together with dataset to filter by measurements. | DBH |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
locationID | simple / all | Darwin Core column: stable identifier of the location record, formatted by OpenDataBio as odb:{installation}:location:{uuid}. |
basisOfRecord | simple / all | Darwin Core column: basisOfRecord value indicating the general type of biological record. |
locationName | simple / all | Darwin Core-compatible location label used by OpenDataBio for the location associated with the record. |
adm_level | simple / all | OpenDataBio local administrative level code for a location. |
country_adm_level | simple / all | OpenDataBio local administrative level code identifying which location level represents the country. |
x | simple / all | OpenDataBio local field for location geometry: X dimension or length of a plot/transect in the location local coordinate system. |
y | simple / all | OpenDataBio local field for location geometry: Y dimension of a plot or buffer/width value for a transect in the location local coordinate system. |
startx | simple / all | OpenDataBio local starting X coordinate for a plot, transect, or local coordinate system. |
starty | simple / all | OpenDataBio local starting Y coordinate for a plot, transect, or local coordinate system. |
distance_to_search | simple / all | OpenDataBio local distance, usually in meters, between a location and the search coordinate. |
parent_id | simple / all | Internal numeric identifier of the parent record in a hierarchy. |
parent_uuid | simple / all | Stable UUID of the parent record in a hierarchy. |
parentName | simple / all | OpenDataBio local name of the parent location. |
higherGeography | simple / all | Darwin Core column: higher geographic context for the location, such as parent locations or administrative hierarchy. |
footprintWKT | simple / all | Darwin Core column: location geometry in WKT format. |
locationRemarks | simple / all | Darwin Core column: remarks or notes about the location. |
decimalLatitude | simple / all | Darwin Core column: latitude in decimal degrees, when coordinates are available for distribution. |
decimalLongitude | simple / all | Darwin Core column: longitude in decimal degrees, when coordinates are available for distribution. |
georeferenceRemarks | simple / all | Darwin Core column: notes describing coordinate origin, uncertainty, georeferencing or location details. |
geodeticDatum | simple / all | Darwin Core column: spatial datum or coordinate reference system used for the coordinates. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 27297,
"basisOfRecord": "Location",
"locationName": "Parcela 1105",
"adm_level": 100,
"country_adm_level": "Parcela",
"x": "100.00",
"y": "100.00",
"startx": null,
"starty": null,
"distance_to_search": null,
"parent_id": 27277,
"parentName": "Fazenda Esteio",
"higherGeography": "Brasil > Amazonas > Rio Preto da Eva > Fazenda Esteio > Parcela 1105",
"footprintWKT": "POLYGON((-59.81371985 -2.42215752,-59.81360263 -2.42126619,-59.81270751 -2.42136656,-59.81282469 -2.42225788,-59.81371985 -2.42215752))",
"locationRemarks": "source: Polígono desenhado a partir das coordenadas de GPS dos vértices; georeferencedBy: Diogo Martins Rosa & Ana Andrade; fundedBy: Edital CNPq-Brasil/LBA 458027/2013-8; geometryBy: Alberto Vicentini; geometryDate: 2021-09-29; warning: Conflito com polígono da UC de 2021. Este polígono deveria ter a mesma geometria do polígono correspondente que faz parte da UC ARIE PDBFF, mas como ele foi gerado pelas coordenadas de campo, foi mantida essa geometria. A UC, portanto, não protege adequadamente essa parcela de monitoramento.",
"decimalLatitude": -2.42215752,
"decimalLongitude": -59.81371985,
"georeferenceRemarks": "decimal coordinates are the START POINT in footprintWKT geometry",
"geodeticDatum": null
}
]
}measurements (GET)
Trait measurements (GET lists, POST creates/imports via ImportMeasurements job, PUT bulk updates).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
bibreference | No | Bibreference id or bibkey. | 34 or ducke1953 |
dataset | No | Dataset id or acronym. | 3 or FOREST1 |
date_max | No | Filter records occurring on/before this date (YYYY-MM-DD). | 2024-12-31 |
date_min | No | Filter records occurring on/after this date (YYYY-MM-DD). | 2020-01-01 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
individual | No | Individual id, uuid or organismID (fullname). | 4521 or 2ff0e884-3d33 |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
limit | No | Maximum number of records to return. | 100 |
location | No | Location id or name. | Parcela 25ha or 55 |
location_root | No | Location id/name with descendants included. | Amazonas or 10 |
measured_id | No | Measurement filter: id of the measured object (matches measured_type). | 4521 |
measured_type | No | Measurement filter: class name of measured object (Individual, Location, Taxon, Voucher, Media). | Media |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
person | No | Person id, abbreviation, full name or email (supports lists with | or ;). | J.Silva|M.Costa |
project | No | Project id or acronym. | PDBFF or 2 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
taxon | No | Taxon id or canonical full name list. | Licaria cannela or 456,789 |
taxon_root | No | Taxon id/name including descendants. | Lauraceae |
trait | No | Trait id or export_name filter. | DBH |
trait_type | No | Filter measurements by trait type code. | 1 |
voucher | No | Voucher id for filtering measurements. | 102 |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
measurementID | simple / all | Darwin Core column: stable identifier of the measurement record, formatted by OpenDataBio as odb:{installation}:measurement:{uuid}. |
dataset_id | simple / all | Internal numeric identifier of the dataset that governs the exported record. |
basisOfRecord | simple / all | Darwin Core column: basisOfRecord value indicating the general type of biological record. |
measured_type | simple / all | OpenDataBio local model type of the object measured by a measurement record. |
measured_id | simple / all | Internal numeric identifier of the object measured by a measurement record. |
measured_uuid | simple / all | Stable UUID of the object measured by a measurement record, when the object has a UUID. |
trait_id | simple / all | Internal numeric identifier of the linked trait. |
trait_uuid | simple / all | Stable UUID of the linked trait. |
measurementType | simple / all | Darwin Core MeasurementOrFact column: trait export name or measurement type represented by the measurement. |
measurementValue | simple / all | Darwin Core MeasurementOrFact column: recorded value of the measurement. |
measurementUnit | simple / all | Darwin Core MeasurementOrFact column: unit associated with the measurement value. |
measurementDeterminedBy | simple / all | Darwin Core MeasurementOrFact column: person or people who determined or recorded the measurement. |
measurementDeterminedDate | simple / all | Darwin Core MeasurementOrFact column: date when the measurement was determined or recorded. |
scientificName | simple / all | Darwin Core taxonomic column: scientific name associated with the record at the time of export. |
family | simple / all | Darwin Core taxonomic column: family associated with the exported taxon or identified organism. |
datasetID | simple / all | Darwin Core column: stable identifier of the dataset governing the record, formatted by OpenDataBio as odb:{installation}:dataset:{uuid}; includes the dataset UUID and installation prefixes. |
datasetName | simple / all | Darwin Core column: name or title of the dataset governing the exported record. |
sourceCitation | simple / all | Citation for the source from which the record or measurement was derived. |
accessRights | simple / all | Darwin Core column: human-readable information about permissions, restrictions, and conditions for using the record, derived from the license and data policy of the dataset governing the record. |
policyCode | simple / all | Compact policy code derived from the dataset license and data-use obligations. |
dataset_uuid | all | Stable UUID of the dataset that governs the exported record. |
measurementRemarks | all | Darwin Core MeasurementOrFact column: notes associated with the measurement. |
resourceRelationship | all | Darwin Core ResourceRelationship column: type of relationship between the exported record and the resource it is linked to. |
resourceRelationshipID | all | Darwin Core relationship column: stable identifier of the related OpenDataBio resource, formatted as odb:{installation}:{type}:{uuid} when the related object has a stable identifier. |
resourceRelationshipName | all | Darwin Core ResourceRelationship-compatible column: human-readable name of the related resource. |
relationshipOfResource | all | Darwin Core relationshipOfResource value describing how the resource is related. |
measurementMethod | all | Darwin Core MeasurementOrFact column: method or protocol used to obtain the measurement, i.e. trait definition and metadata |
bibreference_id | all | Internal numeric identifier of the linked bibliographic reference. |
bibreference_uuid | all | Stable UUID of the linked bibliographic reference. |
measurementLocationId | all | Internal numeric identifier of the location associated with the measurement. |
measurementLocationUuid | all | Stable UUID of the location associated with the measurement. |
measurementParentId | all | Internal numeric identifier of the parent measurement when this measurement is nested. |
measurementParentUuid | all | Stable UUID of the parent measurement when this measurement is nested. |
decimalLatitude | all | Darwin Core column: latitude in decimal degrees, when coordinates are available for distribution. |
decimalLongitude | all | Darwin Core column: longitude in decimal degrees, when coordinates are available for distribution. |
policyUrl | all | URL where the full dataset policy can be read for the governing dataset or version. |
policySummary | all | Short plain-language summary of the data-use permissions and obligations. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 853443,
"basisOfRecord": "MeasurementsOrFact",
"measured_type": "App\\Models\\Voucher",
"measured_id": 1519,
"measurementType": "HasSilica",
"measurementValue": "Sim",
"measurementUnit": null,
"measurementDeterminedDate": "2014-09-24",
"measurementDeterminedBy": "Equipe FITO",
"measurementRemarks": null,
"resourceRelationship": null,
"resourceRelationshipID": "3304.8846.Equipe-FITO.PDBFF.PDBFF005425",
"relationshipOfResource": "measurement of",
"scientificName": "Pouteria fimbriata",
"family": "Sapotaceae",
"datasetName": "SILICOTECA",
"measurementMethod": "Name: Has sílica-gel sample for DNA extraction | Definition:Has a tissue preserved in sílica-gel for DNA extractions. | Categories: CategoryName: Yes | Definition:Has an associated sample in sílica-gel.",
"sourceCitation": null,
"measurementLocationId": 29639,
"measurementParentId": null,
"decimalLatitude": -2.36495453,
"decimalLongitude": -59.97365135
}
]
}media (GET)
Media metadata (GET lists, POST creates, PUT updates).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
dataset | No | Dataset id or acronym. | 3 or FOREST1 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
individual | No | Individual id, uuid or organismID (fullname). | 4521 or 2ff0e884-3d33 |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
limit | No | Maximum number of records to return. | 100 |
location | No | Location id or name. | Parcela 25ha or 55 |
location_root | No | Location id/name with descendants included. | Amazonas or 10 |
media_id | No | Media numeric id. | 88 |
media_uuid | No | Media UUID. | a3f0a4ac-6b5b-11ed-b8c0-0242ac120002 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
person | No | Person id, abbreviation, full name or email (supports lists with | or ;). | J.Silva|M.Costa |
project | No | Project id or acronym. | PDBFF or 2 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
tag | No | Individual tag/number/code. | A-1234 |
taxon | No | Taxon id or canonical full name list. | Licaria cannela or 456,789 |
taxon_root | No | Taxon id/name including descendants. | Lauraceae |
uuid | No | — | |
voucher | No | Voucher id for filtering measurements. | 102 |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
model_type | simple / all | OpenDataBio local model class of the object linked to a media record. |
model_id | simple / all | Internal numeric identifier of the OpenDataBio object linked to a media record. |
model_uuid | simple / all | Stable UUID of the OpenDataBio object linked to a media record. |
dataset_id | simple / all | Internal numeric identifier of the dataset that governs the exported record. |
dataset_uuid | simple / all | Stable UUID of the dataset that governs the exported record. |
project_id | simple / all | Internal numeric identifier of the project linked to the record or dataset. |
project_uuid | simple / all | Stable UUID of the project linked to the record or dataset. |
basisOfRecord | simple / all | Darwin Core column: basisOfRecord value indicating the general type of biological record. |
recordedBy | simple / all | Darwin Core column: collectors or observers associated with the record. |
eventDate | simple / all | Darwin Core column: date or interval during which the collection, observation, media capture, or occurrence event took place. |
dwcType | simple / all | Darwin Core / Dublin Core type value of the media or linked resource. |
resourceRelationship | simple / all | Darwin Core ResourceRelationship column: type of relationship between the exported record and the resource it is linked to. |
resourceRelationshipID | simple / all | Darwin Core relationship column: stable identifier of the related OpenDataBio resource, formatted as odb:{installation}:{type}:{uuid} when the related object has a stable identifier. |
resourceRelationshipName | simple / all | Darwin Core ResourceRelationship-compatible column: human-readable name of the related resource. |
relationshipOfResource | simple / all | Darwin Core relationshipOfResource value describing how the resource is related. |
scientificName | simple / all | Darwin Core taxonomic column: scientific name associated with the record at the time of export. |
family | simple / all | Darwin Core taxonomic column: family associated with the exported taxon or identified organism. |
datasetID | simple / all | Darwin Core column: stable identifier of the dataset governing the record, formatted by OpenDataBio as odb:{installation}:dataset:{uuid}; includes the dataset UUID and installation prefixes. |
datasetName | simple / all | Darwin Core column: name or title of the dataset governing the exported record. |
projectName | simple / all | Name or acronym of the project linked to the record or dataset. |
taggedWith | simple / all | Tags or keywords associated with the record. |
accessRights | simple / all | Darwin Core column: human-readable information about permissions, restrictions, and conditions for using the record, derived from the license and data policy of the dataset governing the record. |
policyCode | simple / all | Compact policy code derived from the dataset license and data-use obligations. |
license | simple / all | License assigned to the media file or dataset resource. |
file_name | simple / all | Stored file name for a media object or downloadable dataset file. |
file_url | simple / all | Public URL for retrieving the media file or downloadable file. |
citation | simple / all | Human-readable citation associated with the record or media file. |
recordedDate | all | OpenDataBio legacy column equivalent to Darwin Core eventDate. Kept in all exports for backward compatibility; prefer eventDate for interoperability. |
policyUrl | all | URL where the full dataset policy can be read for the governing dataset or version. |
policySummary | all | Short plain-language summary of the data-use permissions and obligations. |
bibliographicCitation | all | Darwin Core / Dublin Core column: formatted bibliographic citation associated with the record. |
bibtex | all | BibTeX representation of the bibliographic reference or media citation. |
userName | all | Name of the OpenDataBio user associated with the record action. |
created_at | all | Timestamp when the record was created in OpenDataBio. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 20211,
"model_type": "App\\Models\\Individual",
"model_id": 111785,
"basisOfRecord": "MachineObservation",
"recordedBy": "Francisco Javier Farroñay Pacaya",
"recordedDate": "2025-03-09",
"dwcType": "StillImage",
"resourceRelationship": "Organism",
"resourceRelationshipID": "3402-1134_Pereira_1986",
"relationshipOfResource": "StillImage of ",
"scientificName": "Sacoglottis guianensis",
"family": "Humiriaceae",
"datasetName": "Unknown dataset",
"projectName": "Projeto Dinâmica Biológica de Fragmentos Florestais",
"taggedWith": "Folha abaxial",
"accessRights": "Open access.",
"bibliographicCitation": "Sacoglottis guianensis (Humiriaceae). (2025). By Francisco Javier Farroñay Pacaya. Collection: Pereira, M.J.R. #3402-1134 on 1986-01-24, from Quadrante 52, Parcela 3402-3, Reserva 3402, Cabo Frio, Fazenda Porto Alegre, Amazonas, Brasil (PDBFF). Project: PDBFF-Data. Instituto Nacional de Pesquisas da Amazônia (INPA), Manaus, Amazonas, Brasil. Type: Image. License: CC-BY-NC-SA 4.0. uuid: inpa-odb-3f139ba4-f22b-42d8-9e74-c340309061c2, url: http://localhost/opendatabio",
"license": "CC-BY-NC-SA 4.0",
"file_name": "67ce28cd76f4a.jpg",
"file_url": "http://localhost/opendatabio/storage/media/20211/67ce28cd76f4a.jpg",
"citation": "Sacoglottis guianensis (Humiriaceae). (2025). By Francisco Javier Farroñay Pacaya. Collection: Pereira, M.J.R. #3402-1134 on 1986-01-24, from Quadrante 52, Parcela 3402-3, Reserva 3402, Cabo Frio, Fazenda Porto Alegre, Amazonas, Brasil (PDBFF). Project: PDBFF-Data. Instituto Nacional de Pesquisas da Amazônia (INPA), Manaus, Amazonas, Brasil. Type: Image. License: CC-BY-NC-SA 4.0. uuid: inpa-odb-3f139ba4-f22b-42d8-9e74-c340309061c2, url: http://localhost/opendatabio",
"uuid": "3f139ba4-f22b-42d8-9e74-c340309061c2",
"bibtex": "@misc{Farronay_2025_20211,\n{\n \"title\": \" Sacoglottis guianensis (Humiriaceae)\",\n \"year\": \"(2025)\",\n \"author\": \"Francisco Javier Farroñay Pacaya\",\n \"howpublished\": \"{http:\\/\\/localhost\\/opendatabio\\/media\\/uuid\\/3f139ba4-f22b-42d8-9e74-c340309061c2}\",\n \"license\": \"CC-BY-NC-SA 4.0\",\n \"note\": \"Type: Image; Collection: Pereira, M.J.R. #3402-1134 on 1986-01-24, from Quadrante 52, Parcela 3402-3, Reserva 3402, Cabo Frio, Fazenda Porto Alegre, Amazonas, Brasil (PDBFF); Coordinates: POINT(-59.91500315727877 -2.3929141688648765); License: CC-BY-NC-SA 4.0; Project: PDBFF-Data.; Accessed: 2026-02-04\",\n \"publisher\": \"Instituto Nacional de Pesquisas da Amazônia (INPA), Manaus, Amazonas, Brasil\"\n}\n}",
"userName": "example",
"created_at": "2025-03-09T23:48:29.000000Z"
}
]
}persons (GET)
People (GET lists, POST creates, PUT updates).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
abbrev | No | Abbreviation search for persons. | Silva, J.B, Pilco, M.V. |
email | No | Email address. | user@example.org |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
limit | No | Maximum number of records to return. | 100 |
name | No | Translatable trait name. Accepts a plain string or a JSON map of language codes to names. | {"en":"Height","pt-br":"Altura"} |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
search | No | Full-text search parameter. | Silva |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
full_name | simple / all | OpenDataBio local full name of a person. |
abbreviation | simple / all | OpenDataBio local abbreviation for a person or biocollection. |
emailAddress | simple / all | OpenDataBio local person email address when it is available for export. |
institution | simple / all | OpenDataBio local institution associated with a person. |
orcid | simple / all | ORCID identifier associated with a person. |
notes | simple / all | OpenDataBio local notes associated with the exported resource. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 3127,
"full_name": "Raimundo Afeganistão",
"abbreviation": "AFEGANISTÃO, R.",
"emailAddress": null,
"institution": null,
"notes": "PDBFF"
},
{
"id": 14,
"full_name": "Maria de Fátima Agra",
"abbreviation": "Agra, M.F.",
"emailAddress": null,
"institution": null,
"notes": null
},
{
"id": 15,
"full_name": "J. L. A. Aguiar Jr",
"abbreviation": "Aguiar Jr., J.L.A.",
"emailAddress": null,
"institution": null,
"notes": null
}
]
}projects (GET)
Projects (GET lists).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
limit | No | Maximum number of records to return. | 100 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
search | No | Full-text search parameter. | Silva |
tag | No | Individual tag/number/code. | A-1234 |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
acronym | simple / all | OpenDataBio local acronym for a project or biocollection. |
name | simple / all | OpenDataBio local name of the exported resource. |
description | simple / all | OpenDataBio local descriptive text for the exported resource. |
pages | all | OpenDataBio local project pages metadata. |
urls | all | OpenDataBio local list of URLs associated with a project. |
created_at | all | Timestamp when the record was created in OpenDataBio. |
updated_at | all | Timestamp when the record was last updated in OpenDataBio. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 1,
"acronym": "PDBFF-Data",
"name": "Projeto Dinâmica Biológica de Fragmentos Florestais",
"description": "Este espaço agrega conjuntos de dados de monitoramentos e pesquisas realizadas nas áreas amostrais do PDBFF, localizadas na Área de Relevante Interesse Ecológico - ARIE PDBFF.",
"pages": {
"en": null,
"pt-br": null
},
"urls": [
{
"url": "https://alfa-pdbff.site/",
"label": null,
"icon": "fa-solid fa-globe"
}
],
"created_at": "2022-10-31T07:01:18.000000Z",
"updated_at": "2023-11-17T21:08:55.000000Z"
}
]
}taxons (GET)
Taxonomic names (GET lists, POST creates).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
bibreference | No | Bibreference id or bibkey. | 34 or ducke1953 |
biocollection | No | Biocollection id, name or acronym. | INPA |
dataset | No | Dataset id or acronym. | 3 or FOREST1 |
external | No | Flag to include external ids (Tropicos, IPNI, etc.). | 1 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
level | No | Taxon rank code or string. | 210 or species |
limit | No | Maximum number of records to return. | 100 |
location_root | No | Location id/name with descendants included. | Amazonas or 10 |
name | No | Translatable trait name. Accepts a plain string or a JSON map of language codes to names. | {"en":"Height","pt-br":"Altura"} |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
person | No | Person id, abbreviation, full name or email (supports lists with | or ;). | J.Silva|M.Costa |
project | No | Project id or acronym. | PDBFF or 2 |
root | No | Root id for hierarchical queries (taxon or location). | 120 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
taxon_root | No | Taxon id/name including descendants. | Lauraceae |
trait | No | Trait id or export_name filter. | DBH |
valid | No | When 1, return only valid taxon names. | 1 |
vernacular | No | Vernacular id or name list used to filter individuals. | castanha|12 |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
basisOfRecord | simple / all | Darwin Core column: basisOfRecord value indicating the general type of biological record. |
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
scientificNameID | simple / all | Darwin Core taxonomic column: stable identifier of the taxonomic name record, formatted by OpenDataBio as odb:{installation}:taxon:{uuid}. |
scientificName | simple / all | Darwin Core taxonomic column: scientific name associated with the record at the time of export. |
taxonRank | simple / all | Darwin Core taxonomic column: taxonomic rank of the scientific name. |
scientificNameAuthorship | simple / all | Darwin Core taxonomic column: authorship string associated with the scientific name. |
namePublishedIn | simple / all | Darwin Core taxonomic column: bibliographic reference in which the taxonomic name was published. |
parentNameUsageID | simple / all | Darwin Core taxonomic column: stable identifier of the parent taxon, formatted by OpenDataBio as odb:{installation}:taxon:{uuid}. |
parentNameUsage | simple / all | Darwin Core taxonomic column: parent taxon name in the taxonomic hierarchy. |
family | simple / all | Darwin Core taxonomic column: family associated with the exported taxon or identified organism. |
higherClassification | simple / all | Darwin Core taxonomic column: higher taxonomic classification path for the taxon. |
taxonRemarks | simple / all | Darwin Core taxonomic column: remarks about the taxon. |
taxonomicStatus | simple / all | Darwin Core taxonomic column: taxonomic status of the name, such as accepted name or synonym. |
acceptedNameUsage | simple / all | Darwin Core taxonomic column: accepted scientific name when the exported name is not accepted. |
acceptedNameUsageID | simple / all | Darwin Core taxonomic column: stable identifier of the accepted taxonomic name, formatted by OpenDataBio as odb:{installation}:taxon:{uuid}. |
author_uuid | all | Stable UUID of the person linked as author of an unpublished taxonomic name. |
bibreference_uuid | all | Stable UUID of the linked bibliographic reference. |
parent_id | all | Internal numeric identifier of the parent record in a hierarchy. |
parent_uuid | all | Stable UUID of the parent record in a hierarchy. |
senior_id | all | Internal numeric identifier of the accepted or senior taxonomic name. |
externalKeys | all | OpenDataBio local external database identifiers linked to a taxonomic name. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 16332,
"senior_id": null,
"parent_id": 16331,
"author_id": null,
"scientificName": "Aiouea grandifolia",
"taxonRank": "Species",
"scientificNameAuthorship": "van der Werff",
"namePublishedIn": null,
"parentName": "Aiouea",
"family": "Lauraceae",
"higherClassification": "Eukaryota > Plantae > Viridiplantae > Embryophytes > Spermatopsida > Angiosperms > Magnoliidae > Laurales > Lauraceae > Aiouea",
"taxonRemarks": null,
"taxonomicStatus": "accepted",
"acceptedNameUsage": null,
"acceptedNameUsageID": null,
"parentNameUsage": "Aiouea",
"scientificNameID": "https://tropicos.org/Name/17806050 | https://www.gbif.org/species/4175896",
"basisOfRecord": "Taxon"
}
]
}traits (GET)
Trait definitions (GET lists, POST creates).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
bibreference | No | Bibreference id or bibkey. | 34 or ducke1953 |
categories | No | Trait categories JSON list with lang/rank/name/description. | [{\"lang\":\"en\",\"rank\":1,\"name\":\"small\"}] |
dataset | No | Dataset id or acronym. | 3 or FOREST1 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
language | No | Language id/code/name. For POST vernaculars, registered languages are accepted; absent languages are created from config/languagesISO6393.php only when the informed value matches an ISO639-3 code or configured language name, with is_locale=0. | en or 1 or english or spa |
limit | No | Maximum number of records to return. | 100 |
name | No | Translatable trait name. Accepts a plain string or a JSON map of language codes to names. | {"en":"Height","pt-br":"Altura"} |
object_type | No | Measured object type: Individual, Location, Taxon, Voucher, or Media. | Individual |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
search | No | Full-text search parameter. | Silva |
tag | No | Individual tag/number/code. | A-1234 |
taxon | No | Taxon id or canonical full name list. | Licaria cannela or 456,789 |
taxon_root | No | Taxon id/name including descendants. | Lauraceae |
trait | No | Trait id or export_name filter. | DBH |
type | No | Generic type parameter (trait type code or vernacular type such as use/generic/etimology). | use or 10 |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
parent_id | simple / all | Internal numeric identifier of the parent record in a hierarchy. |
parent_uuid | simple / all | Stable UUID of the parent record in a hierarchy. |
type | simple / all | OpenDataBio local type code or type label of the exported resource. |
typename | simple / all | OpenDataBio local human-readable name of a trait type. |
export_name | simple / all | OpenDataBio local stable export name of a trait, used as a public field key in measurements. |
unit | simple | OpenDataBio local measurement unit configured for a trait. |
range_min | simple / all | OpenDataBio local minimum valid value configured for a quantitative trait. |
range_max | simple / all | OpenDataBio local maximum valid value configured for a quantitative trait. |
link_type | simple / all | OpenDataBio local target object type allowed for a link trait. |
value_length | simple / all | OpenDataBio local number of values expected for a spectral trait. |
name | simple / all | OpenDataBio local name of the exported resource. |
description | simple / all | OpenDataBio local descriptive text for the exported resource. |
objects | simple / all | OpenDataBio local list of object types to which a trait can apply. |
measurementType | simple / all | Darwin Core MeasurementOrFact column: trait export name or measurement type represented by the measurement. |
categories | simple / all | OpenDataBio local list of trait categories, including labels and descriptions when available. |
bibreference_id | all | Internal numeric identifier of the linked bibliographic reference. |
bibreference_uuid | all | Stable UUID of the linked bibliographic reference. |
measurementUnit | all | Darwin Core MeasurementOrFact column: unit associated with the measurement value. |
measurementMethod | all | Darwin Core MeasurementOrFact column: method or protocol used to obtain the measurement, i.e. trait definition and metadata |
MeasurementTypeBibkeys | all | OpenDataBio local list of bibliographic keys that support the trait measurement type. |
TaggedWith | all | OpenDataBio local list of tags associated with a trait. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 206,
"type": 1,
"typename": "QUANT_REAL",
"export_name": "treeDbh",
"measurementType": "treeDbh",
"measurementUnit": "cm",
"range_min": 0.1,
"range_max": 700,
"link_type": null,
"value_length": null,
"name": "Diâmetro à altura do peito – DAP",
"description": "Diâmetro à altura do peito, i.e. medido a ca. 1.3m desde a base do caule",
"objects": "App\\Models\\Individual | App\\Models\\Voucher | App\\Models\\Location | App\\Models\\Taxon | App\\Models\\Media",
"measurementMethod": "Name: Diameter at breast height - DBH | Definition:Diameter at breast height,, i.e. ca. 1.3 meters from the base of the trunk",
"MeasurementTypeBibkeys": "",
"TaggedWith": "",
"categories": null
},
{
"id": 207,
"type": 1,
"typename": "QUANT_REAL",
"export_name": "treeDbhPom",
"measurementType": "treeDbhPom",
"measurementUnit": "m",
"range_min": 0,
"range_max": 15,
"link_type": null,
"value_length": null,
"name": "Ponto de medição do DAP",
"description": "Ponto de medição do DAP, necessário quando impossível medir a 1.3 m",
"objects": "App\\Models\\Individual",
"measurementMethod": "Name: DBH Point of Measurement | Definition:DAP measuring height, necessary when impossible to measure at 1.3 m",
"MeasurementTypeBibkeys": "",
"TaggedWith": "",
"categories": null
},
{
"id": 524,
"type": 2,
"typename": "CATEGORICAL",
"export_name": "stemType",
"measurementType": "stemType",
"measurementUnit": null,
"range_min": null,
"range_max": null,
"link_type": null,
"value_length": null,
"name": "Tipo de fuste",
"description": "Tipo de fuste",
"objects": "App\\Models\\Voucher | App\\Models\\Individual | App\\Models\\Taxon",
"measurementMethod": "Name: Type of stem | Definition:Type of stem | Categories: CategoryName: Main stem | Definition:The main trunk, usually the thickest. | CategoryName: Secondary stem | Definition:A secondary trunk, there is a thicker one, which defines the area better. A shoot below 1.3 m high is a secondary trunk.",
"MeasurementTypeBibkeys": "",
"TaggedWith": "",
"categories": [
{
"id": 12990,
"name": "Fuste principal",
"description": "O tronco principal, geralmente o mais grosso.",
"rank": 1,
"belongs_to_trait": "stemType"
},
{
"id": 12991,
"name": "Fuste secundário",
"description": "Um tronco secundário, há outro mais grosso, que define melhor a área. Um rebroto abaixo de 1.3 m de altura é um tronco secundário.",
"rank": 2,
"belongs_to_trait": "stemType"
}
]
}
]
}vernaculars (GET)
Vernacular names (GET lists, POST creates).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
individual | No | Individual id, uuid or organismID (fullname). | 4521 or 2ff0e884-3d33 |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
limit | No | Maximum number of records to return. | 100 |
location | No | Location id or name. | Parcela 25ha or 55 |
location_root | No | Location id/name with descendants included. | Amazonas or 10 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
taxon | No | Taxon id or canonical full name list. | Licaria cannela or 456,789 |
taxon_root | No | Taxon id/name including descendants. | Lauraceae |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
name | simple / all | OpenDataBio local name of the exported resource. |
languageName | simple / all | OpenDataBio local language name associated with a vernacular name. |
notes | simple / all | OpenDataBio local notes associated with the exported resource. |
locationsList | simple / all | OpenDataBio local human-readable list of locations linked to the record. |
taxonsList | simple / all | OpenDataBio local human-readable list of taxa linked to the record. |
individualsList | simple / all | OpenDataBio local human-readable list of individuals linked to the record. |
citationsArray | simple / all | OpenDataBio local structured list of citations linked to a vernacular name. |
languageCode | all | OpenDataBio local language code associated with a vernacular name. |
taxonsListArray | all | OpenDataBio local structured array of taxa linked to the record. |
individualsListArray | all | OpenDataBio local structured array of individuals linked to the record. |
locationsListArray | all | OpenDataBio local structured array of locations linked to the record. |
variantsList | all | OpenDataBio local human-readable list of vernacular variants linked to the record. |
variantsListArray | all | OpenDataBio local structured array of vernacular variants linked to the record. |
createdBy | all | OpenDataBio local user or person who created the record. |
created_at | all | Timestamp when the record was created in OpenDataBio. |
updated_at | all | Timestamp when the record was last updated in OpenDataBio. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": []
}vouchers (GET)
Voucher specimens (GET lists, POST creates, PUT updates).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
bibreference | No | Bibreference id or bibkey. | 34 or ducke1953 |
bibreference_id | No | BibReference id list for voucher filtering. | 10,11 |
biocollection | No | Biocollection id, name or acronym. | INPA |
biocollection_id | No | Biocollection id list for voucher filtering. | 1,5 |
collector | No | Collector(s) id, abbreviation, name or email. Use | or ; to separate multiple people; first is main collector. | J.Silva|M.Costa |
dataset | No | Dataset id or acronym. | 3 or FOREST1 |
date_max | No | Filter records occurring on/before this date (YYYY-MM-DD). | 2024-12-31 |
date_min | No | Filter records occurring on/after this date (YYYY-MM-DD). | 2020-01-01 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
individual | No | Individual id, uuid or organismID (fullname). | 4521 or 2ff0e884-3d33 |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
limit | No | Maximum number of records to return. | 100 |
location | No | Location id or name. | Parcela 25ha or 55 |
location_root | No | Location id/name with descendants included. | Amazonas or 10 |
main_collector | No | Boolean (1) to filter vouchers by main collector only. | 1 |
number | No | Collector number/code (voucher/individual tag when different from individual). | 1234A |
odbrequest_id | No | Filter individuals linked to a given request id. | 12 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
person | No | Person id, abbreviation, full name or email (supports lists with | or ;). | J.Silva|M.Costa |
project | No | Project id or acronym. | PDBFF or 2 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
taxon | No | Taxon id or canonical full name list. | Licaria cannela or 456,789 |
taxon_root | No | Taxon id/name including descendants. | Lauraceae |
trait | No | Trait id or export_name filter. | DBH |
vernacular | No | Vernacular id or name list used to filter individuals. | castanha|12 |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
uuid | simple / all | Stable UUID of the exported record. |
individual_uuid | simple / all | Stable UUID of the linked individual or organism record. |
basisOfRecord | simple / all | Darwin Core column: basisOfRecord value indicating the general type of biological record. |
occurrenceID | simple / all | Darwin Core column: stable identifier of the biological occurrence record. In OpenDataBio, an occurrence should represent the presence/record of an organism or taxon at a location. |
organismID | simple / all | Darwin Core column: stable identifier of the organism/individual, formatted by OpenDataBio as odb:{installation}:individual:{uuid}. |
organismName | simple / all | Darwin Core column: human-readable label for the organism or individual record. |
materialEntityID | simple / all | Darwin Core column: stable identifier of the physical material entity. In OpenDataBio voucher exports, this is the voucher stable identifier formatted as odb:{installation}:voucher:{uuid}. |
collectionCode | simple / all | Darwin Core column: code, acronym, or name identifying the biological collection. |
catalogNumber | simple / all | Darwin Core column: catalog number or accession number of the voucher in the biological collection. |
typeStatus | simple / all | Darwin Core column: nomenclatural type status of a voucher specimen. |
recordedByMain | simple / all | Main collector or observer responsible for the record. |
recordNumber | simple / all | Darwin Core column: collector or observer record number. |
eventDate | simple / all | Darwin Core column: date or interval during which the collection, observation, media capture, or occurrence event took place. |
recordedBy | simple / all | Darwin Core column: collectors or observers associated with the record. |
scientificName | simple / all | Darwin Core taxonomic column: scientific name associated with the record at the time of export. |
family | simple / all | Darwin Core taxonomic column: family associated with the exported taxon or identified organism. |
identificationQualifier | simple / all | Darwin Core column: qualifier expressing uncertainty or qualification of the identification. |
identifiedBy | simple / all | Darwin Core column: person or people responsible for the taxonomic identification. |
dateIdentified | simple / all | Darwin Core column: date when the taxonomic identification was made. |
identificationRemarks | simple / all | Darwin Core column: notes associated with the taxonomic identification. |
location_id | simple / all | Internal numeric identifier of the linked location. |
location_uuid | simple / all | Stable UUID of the linked location. |
locationName | simple / all | Darwin Core-compatible location label used by OpenDataBio for the location associated with the record. |
higherGeography | simple / all | Darwin Core column: higher geographic context for the location, such as parent locations or administrative hierarchy. |
decimalLatitude | simple / all | Darwin Core column: latitude in decimal degrees, when coordinates are available for distribution. |
decimalLongitude | simple / all | Darwin Core column: longitude in decimal degrees, when coordinates are available for distribution. |
occurrenceRemarks | simple / all | Darwin Core column: remarks about the occurrence. |
datasetID | simple / all | Darwin Core column: stable identifier of the dataset governing the record, formatted by OpenDataBio as odb:{installation}:dataset:{uuid}; includes the dataset UUID and installation prefixes. |
datasetName | simple / all | Darwin Core column: name or title of the dataset governing the exported record. |
accessRights | simple / all | Darwin Core column: human-readable information about permissions, restrictions, and conditions for using the record, derived from the license and data policy of the dataset governing the record. |
policyCode | simple / all | Compact policy code derived from the dataset license and data-use obligations. |
dataset_id | all | Internal numeric identifier of the dataset that governs the exported record. |
individual_id | all | Internal numeric identifier of the linked individual or organism record. |
recordedDate | all | OpenDataBio legacy column equivalent to Darwin Core eventDate. Kept in all exports for backward compatibility; prefer eventDate for interoperability. |
scientificNameAuthorship | all | Darwin Core taxonomic column: authorship string associated with the scientific name. |
taxon_id | all | Internal numeric identifier of the linked taxonomic name. |
taxon_uuid | all | Stable UUID of the linked taxonomic name. |
identification_id | all | Internal numeric identifier of the taxonomic identification linked to the record. |
identification_uuid | all | Stable UUID of the taxonomic identification linked to the record. |
taxonPublishedStatus | all | Publication status of the taxonomic name used in the identification. |
genus | all | Darwin Core taxonomic column: genus associated with the exported taxon or identified organism. |
georeferenceRemarks | all | Darwin Core column: notes describing coordinate origin, uncertainty, georeferencing or location details. |
relatedLocations | all | Other locations related to the record that may not fit political administrative boundaries, such as Indigeneous Territories, Protected areas and environmental layers stored in the Opendatabio installation |
policyUrl | all | URL where the full dataset policy can be read for the governing dataset or version. |
policySummary | all | Short plain-language summary of the data-use permissions and obligations. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 72209,
"individual_id": 306246,
"basisOfRecord": "PreservedSpecimens",
"occurrenceID": "2639.Spruce.K.K000640463",
"organismID": "2639_Spruce_1852",
"collectionCode": "K",
"catalogNumber": "K000640463",
"typeStatus": "Tipo",
"recordedByMain": "Spruce, R.",
"recordNumber": "2639",
"recordedDate": "1852-10",
"recordedBy": "Spruce, R.",
"scientificName": "Ecclinusa lanceolata",
"scientificNameAuthorship": "(Mart. & Eichler) Pierre",
"taxonPublishedStatus": "published",
"genus": "Ecclinusa",
"family": "Sapotaceae",
"identificationQualifier": "",
"identifiedBy": "Spruce, R.",
"dateIdentified": "1852-10-00",
"identificationRemarks": "",
"locationName": "São Gabriel da Cachoeira",
"higherGeography": "Brasil > Amazonas > São Gabriel da Cachoeira",
"decimalLatitude": 1.1841927,
"decimalLongitude": -66.80167715,
"georeferenceRemarks": "decimal coordinates are the CENTROID of the footprintWKT geometry",
"occurrenceRemarks": "OrganismRemarks = prope Panure ad Rio Vaupes Amazonas, Brazil",
"datasetName": "Exsicatas LABOTAM",
"uuid": "6302316f-2b48-43b5-816b-005df70d15c9"
}
]
}userjobs (GET)
Background jobs (imports/exports) (GET lists).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
get_file | No | When 1 and used with userjobs id, returns job prepared file. | 1 |
limit | No | Maximum number of records to return. | 100 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
status | No | Job status filter (Submitted, Processing, Success, Failed, Cancelled). | Success |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
dispatcher | simple / all | OpenDataBio local job dispatcher class or job type. |
status | simple / all | OpenDataBio local status of a background job or exported resource. |
percentage | simple / all | OpenDataBio local progress percentage for a background job. |
created_at | simple / all | Timestamp when the record was created in OpenDataBio. |
affected_ids_count | simple / all | OpenDataBio local count of records affected by a background job. |
affected_model | simple / all | OpenDataBio local model class or model name affected by a background job. |
updated_at | all | Timestamp when the record was last updated in OpenDataBio. |
affected_ids | all | OpenDataBio local list of record ids affected by a background job. |
log | all | OpenDataBio local text log produced by a background job. |
Response example
{
"message": "Unauthenticated",
"0": 401
}activities (GET)
Lists activity log entries.
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
description | No | Translatable description text. Accepts a plain string or a JSON map of language codes to descriptions. | {"en":"Tree height at breast height","pt-br":"Altura da árvore à altura do peito"} |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
individual | No | Individual id, uuid or organismID (fullname). | 4521 or 2ff0e884-3d33 |
language | No | Language id/code/name. For POST vernaculars, registered languages are accepted; absent languages are created from config/languagesISO6393.php only when the informed value matches an ISO639-3 code or configured language name, with is_locale=0. | en or 1 or english or spa |
limit | No | Maximum number of records to return. | 100 |
location | No | Location id or name. | Parcela 25ha or 55 |
log_name | No | Activity log name filter. | default |
measurement | No | Activity filter: measurement id. | 55 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
subject | No | Activity filter: subject type (class basename). | Individual |
subject_id | No | Activity filter: subject id. | 12 |
taxon | No | Taxon id or canonical full name list. | Licaria cannela or 456,789 |
taxon_root | No | Taxon id/name including descendants. | Lauraceae |
voucher | No | Voucher id for filtering measurements. | 102 |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
log_name | simple / all | OpenDataBio local activity log name. |
description | simple / all | OpenDataBio local descriptive text for the exported resource. |
subject_type | simple / all | OpenDataBio local model class of the object recorded in an activity log entry. |
subject_name | simple / all | OpenDataBio local human-readable name of the object recorded in an activity log entry. |
subject_id | simple / all | Internal numeric identifier of the object recorded in an activity log entry. |
modified_by | simple / all | OpenDataBio local user who modified the activity subject. |
properties | simple / all | OpenDataBio local structured activity properties, usually encoded as JSON. |
created_at | simple / all | Timestamp when the record was created in OpenDataBio. |
updated_at | simple / all | Timestamp when the record was last updated in OpenDataBio. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"field_key": "taxon_id",
"field": "Taxon",
"old_value": "Burseraceae",
"new_value": "Protium hebetatum forma.b.fito",
"id": 1411696,
"log_name": "individual",
"description": "identification updated",
"subject_type": "App\\Models\\Individual",
"subject_id": 301705,
"subject_name": null,
"modified_by": "example"
},
{
"field_key": "person_id",
"field": "Person",
"old_value": "Macedo, M.T.S",
"new_value": "Pilco, M.V.",
"id": 1411696,
"log_name": "individual",
"description": "identification updated",
"subject_type": "App\\Models\\Individual",
"subject_id": 301705,
"subject_name": null,
"modified_by": "example"
},
{
"field_key": "notes",
"field": "Notes",
"old_value": "Identificação feita em campo, anotada na planilha de dados.",
"new_value": null,
"id": 1411696,
"log_name": "individual",
"description": "identification updated",
"subject_type": "App\\Models\\Individual",
"subject_id": 301705,
"subject_name": null,
"modified_by": "example"
},
{
"field_key": "date",
"field": "Date",
"old_value": "2022-06-17",
"new_value": "2022-11-23",
"id": 1411696,
"log_name": "individual",
"description": "identification updated",
"subject_type": "App\\Models\\Individual",
"subject_id": 301705,
"subject_name": null,
"modified_by": "example"
}
]
}tags (GET)
Tags/keywords (GET lists).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
dataset | No | Dataset id or acronym. | 3 or FOREST1 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
language | No | Language id/code/name. For POST vernaculars, registered languages are accepted; absent languages are created from config/languagesISO6393.php only when the informed value matches an ISO639-3 code or configured language name, with is_locale=0. | en or 1 or english or spa |
limit | No | Maximum number of records to return. | 100 |
name | No | Translatable trait name. Accepts a plain string or a JSON map of language codes to names. | {"en":"Height","pt-br":"Altura"} |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
project | No | Project id or acronym. | PDBFF or 2 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
search | No | Full-text search parameter. | Silva |
trait | No | Trait id or export_name filter. | DBH |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
name | simple / all | OpenDataBio local name of the exported resource. |
description | simple / all | OpenDataBio local descriptive text for the exported resource. |
counts | all | OpenDataBio local summary counts associated with a tag. |
Response example
{
"meta": {
"odb_version": "0.10.0-alpha1",
"api_version": "v0",
"server": "http://localhost/opendatabio"
},
"data": [
{
"id": 11,
"name": "Folhas adaxial",
"description": "Images of the adaxial surface of leaves",
"counts": {
"Media": 1852,
"Project": 0,
"Dataset": 0,
"ODBTrait": 0
}
},
{
"id": 12,
"name": "Folha forma",
"description": "Imagem mostrando uma folha ou o formato da folha.",
"counts": {
"Media": 713,
"Project": 0,
"Dataset": 0,
"ODBTrait": 0
}
},
{
"id": 13,
"name": "Frutos",
"description": "Imagens com frutos",
"counts": {
"Media": 2595,
"Project": 0,
"Dataset": 0,
"ODBTrait": 0
}
}
]
}brahms (GET)
BRAHMS/INPA formatted individual export (GET lists, queued export with save_job).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
brahms_level | No | BRAHMS export level. Use individual for one row per individual, or voucher for one row per voucher linked to matching individuals. | individual or voucher |
dataset | No | Dataset id or acronym. | 3 or FOREST1 |
date_max | No | Filter records occurring on/before this date (YYYY-MM-DD). | 2024-12-31 |
date_min | No | Filter records occurring on/after this date (YYYY-MM-DD). | 2020-01-01 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
habitattxt_traits | No | Measurement trait id/export_name or JSON note key list for BRAHMS habitattxt. JSON keys are searched in individual and individual-location notes; measurements are searched on individual and current location. Use all or none. | all or soil_type,canopy_opening or none |
habitattxt_traits_header | No | Boolean, or comma-separated boolean list, controlling whether habitattxt trait export_name or JSON key is used as a prefix. | 1 or 1,0,1 |
include_taxon_vernaculars | No | When 1, BRAHMS vernacular also includes names linked to the individual taxon. | 0 |
include_vernaculars | No | When 1, includes vernacular names in BRAHMS output. | 1 |
include_voucher_individuals | No | For BRAHMS individual-level exports with a dataset filter, include individuals outside the dataset when they have vouchers in the requested dataset. | 1 |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
lang | No | Language code/name. For BRAHMS, this must match a languages record where is_locale=1 and is used for trait category and color names; it does not affect vernacular names. | pt-br |
limit | No | Maximum number of records to return. | 100 |
location | No | Location id or name. | Parcela 25ha or 55 |
location_root | No | Location id/name with descendants included. | Amazonas or 10 |
locnotes_traits | No | Measurement trait id/export_name or JSON note key list for BRAHMS locnotes. JSON keys are searched in individual and individual-location notes; measurements are searched on individual and current location. Use all or none. Default none keeps locnotes as individual-location notes only. | none or trail_notes,soil_type |
locnotes_traits_header | No | Boolean, or comma-separated boolean list, controlling whether locnotes trait export_name or JSON key is used as a prefix. | 1 or 1,0,1 |
measurement_dataset | No | Dataset id/name list used to limit measurements summarized in BRAHMS descriptions. | Flora-INPA |
odbrequest_id | No | Filter individuals linked to a given request id. | 12 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
person | No | Person id, abbreviation, full name or email (supports lists with | or ;). | J.Silva|M.Costa |
plantdesc_traits | No | Measurement trait id/export_name or individual JSON note key list for BRAHMS plantdesc. Use all or none. | all or leaf_color,dbh or none |
plantdesc_traits_header | No | Boolean, or comma-separated boolean list, controlling whether plantdesc trait export_name or JSON key is used as a prefix. | 1 or 1,0,1 |
project | No | Project id or acronym. | PDBFF or 2 |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
tag | No | Individual tag/number/code. | A-1234 |
taxon | No | Taxon id or canonical full name list. | Licaria cannela or 456,789 |
taxon_root | No | Taxon id/name including descendants. | Lauraceae |
trait | No | Trait id or export_name filter. | DBH |
vernacular | No | Vernacular id or name list used to filter individuals. | castanha|12 |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
odbUuid | simple / all | BRAHMS/INPA export column: OpenDataBio UUID of the exported source record. |
collector | simple / all | BRAHMS/INPA export column for the main collector name or abbreviation. |
number | simple / all | Record, collection, or BRAHMS number value; the exact meaning depends on the endpoint. |
addcoll | simple / all | BRAHMS/INPA export column for additional collectors. |
colldd | simple / all | BRAHMS/INPA export column for collection day. |
collmm | simple / all | BRAHMS/INPA export column for collection month. |
collyy | simple / all | BRAHMS/INPA export column for collection year. |
family | simple / all | Darwin Core taxonomic column: family associated with the exported taxon or identified organism. |
genus | simple / all | Darwin Core taxonomic column: genus associated with the exported taxon or identified organism. |
sp1 | simple / all | BRAHMS/INPA export column for the first species epithet field. |
sp2 | simple / all | BRAHMS/INPA export column for the second epithet or infraspecific name field. |
detby | simple / all | BRAHMS/INPA export column for the person who identified the specimen or individual. |
country | simple / all | Country name or code associated with a location. |
majorarea | simple / all | BRAHMS/INPA export column for the major geographic area. |
minorarea | simple / all | BRAHMS/INPA export column for the minor geographic area. |
gazetteer | simple / all | BRAHMS/INPA export column for the gazetteer or named locality. |
locnotes | simple / all | BRAHMS/INPA export column for locality notes, related locations, and local position information. |
habitattxt | simple / all | BRAHMS/INPA export column for habitat text, usually derived from measurements of the current location when available. |
lat | simple / all | BRAHMS/INPA export column: latitude value formatted for the BRAHMS exchange table. |
NS | simple / all | BRAHMS/INPA export column indicating whether latitude is north or south. |
long | simple / all | BRAHMS/INPA export column: longitude value formatted for the BRAHMS exchange table. |
EW | simple / all | BRAHMS/INPA export column indicating whether longitude is east or west. |
llunit | simple / all | BRAHMS/INPA export column describing the latitude/longitude unit or format. |
alt | simple / all | BRAHMS/INPA export column for elevation or altitude. |
plantdesc | simple / all | BRAHMS/INPA export column for plant description, derived from individual or voucher measurements and notes. |
vernacular | simple / all | BRAHMS/INPA export column for vernacular names. |
project | simple / all | BRAHMS/INPA export column for project name, acronym, or code. |
campo | all | BRAHMS/INPA export column used by local workflows to identify the field or source context. |
accession | all | BRAHMS/INPA export column for accession or collection accession value. |
prefix | all | BRAHMS/INPA export column for collector number prefix. |
suffix | all | BRAHMS/INPA export column for collector number suffix. |
initial | all | BRAHMS/INPA export column for collector initials or local initials field. |
detstatus | all | BRAHMS/INPA export column for determination status. |
rank1 | all | BRAHMS/INPA export column for infraspecific rank. |
detdd | all | BRAHMS/INPA export column for identification day. |
detmm | all | BRAHMS/INPA export column for identification month. |
detyy | all | BRAHMS/INPA export column for identification year. |
alt1 | all | BRAHMS/INPA export column for secondary elevation or altitude value. |
dups | all | BRAHMS/INPA export column for duplicate specimen information. |
identification-histories (GET)
Identification history records (GET lists, POST creates manual history rows).
| Parameter | Required | Description | Example |
|---|---|---|---|
id | No | Single id or comma-separated list to filter or target records. | 1,2,3 |
biocollection | No | Biocollection id, name or acronym. | INPA |
date_max | No | Filter records occurring on/before this date (YYYY-MM-DD). | 2024-12-31 |
date_min | No | Filter records occurring on/after this date (YYYY-MM-DD). | 2020-01-01 |
fields | No | Comma separated list of the fields to include in the response or special words all/simple/raw, default to simple | id,scientificName or all |
identification_id | No | Identification record id. For POST identification-histories this is optional; when provided, it must belong to individual_id. When omitted, the API derives it from individual_id. | 123 |
individual | No | Individual id, uuid or organismID (fullname). | 4521 or 2ff0e884-3d33 |
individual_id | No | Individual id list for occurrence queries. | 12,55,90 |
job_id | No | Job id to reuse affected ids or filter results from a job. | 1024 |
limit | No | Maximum number of records to return. | 100 |
offset | No | The starting position of the record set to be exported. Used together with limit to limit results. | 10000 |
person | No | Person id, abbreviation, full name or email (supports lists with | or ;). | J.Silva|M.Costa |
save_job | No | If 1, save the results as file to download later via userjobs + get_file = T | 1 |
source | No | Source label for generated or imported records. | api |
taxon | No | Taxon id or canonical full name list. | Licaria cannela or 456,789 |
taxon_root | No | Taxon id/name including descendants. | Lauraceae |
Fields returned
The simple profile is the default response; all adds detailed, technical, or compatibility fields. Use the fields parameter to request an explicit list.
| Field | Profiles | Meaning |
|---|---|---|
id | simple / all | Internal numeric identifier of the exported record in this OpenDataBio installation. |
identification_id | simple / all | Internal numeric identifier of the taxonomic identification linked to the record. |
identification_uuid | simple / all | Stable UUID of the taxonomic identification linked to the record. |
individual_id | simple / all | Internal numeric identifier of the linked individual or organism record. |
individual_uuid | simple / all | Stable UUID of the linked individual or organism record. |
organismID | simple / all | Darwin Core column: stable identifier of the organism/individual, formatted by OpenDataBio as odb:{installation}:individual:{uuid}. |
organismName | simple / all | Darwin Core column: human-readable label for the organism or individual record. |
taxon_id | simple / all | Internal numeric identifier of the linked taxonomic name. |
taxon_uuid | simple / all | Stable UUID of the linked taxonomic name. |
scientificName | simple / all | Darwin Core taxonomic column: scientific name associated with the record at the time of export. |
family | simple / all | Darwin Core taxonomic column: family associated with the exported taxon or identified organism. |
identificationQualifier | simple / all | Darwin Core column: qualifier expressing uncertainty or qualification of the identification. |
identifiedBy | simple / all | Darwin Core column: person or people responsible for the taxonomic identification. |
dateIdentified | simple / all | Darwin Core column: date when the taxonomic identification was made. |
identificationBiocollection | simple / all | Biocollection used as a reference for the identification, when applicable. |
identificationBiocollectionReference | simple / all | Catalog or reference number in the biocollection used for identification. |
identificationRemarks | simple / all | Darwin Core column: notes associated with the taxonomic identification. |
replaced_at | simple / all | Timestamp or date when an identification history row was replaced. |
replacedByName | simple / all | OpenDataBio local name of the identification that replaced this identification history row. |
source | simple / all | OpenDataBio local source label for the record or identification history row. |
scientificNameAuthorship | all | Darwin Core taxonomic column: authorship string associated with the scientific name. |
taxonPublishedStatus | all | Publication status of the taxonomic name used in the identification. |
genus | all | Darwin Core taxonomic column: genus associated with the exported taxon or identified organism. |
identifiers | all | OpenDataBio local list of people responsible for a taxonomic identification. |
modifier | all | OpenDataBio local identification qualifier/modifier code stored with an identification history row. |
date | all | OpenDataBio local date associated with the exported record; the exact event depends on the endpoint. |
biocollection_id | all | Internal numeric identifier of the linked biological collection. |
biocollection_uuid | all | Stable UUID of the linked biological collection. |
replaced_by | all | Internal numeric identifier of the identification history row that replaced this row. |
source_id | all | OpenDataBio local identifier of the source record or source process. |
source_payload | all | OpenDataBio local structured payload from the source process, usually encoded as JSON. |
created_at | all | Timestamp when the record was created in OpenDataBio. |
updated_at | all | Timestamp when the record was last updated in OpenDataBio. |