latestOpenAPI 3.1.02026-08-203343145.3 KB

03ccf35f8dd9

Name parser

Parse a list of scientific names

Parses a list of scientific names supplied as a JSON list, a form request or a plain text file with Unix (\n) line endings. In all cases the names should use UTF-8 encoding.

curl -X POST -H 'Content-Type: application/json' --data-binary @scientific_names.json https://api.gbif.org/v1/species/parser/name
curl -F names=@scientific_names.txt https://api.gbif.org/v1/species/parser/name
curl -X POST -H 'Content-Type: text/plain' --data-binary @scientific_names.txt https://api.gbif.org/v1/species/parser/name

post/v1/parser/name

Request body

string[] required

A list of names to parse, such as ["First name", "Second name"].

Response

Parsed name usages

keyinteger

The key for this parsed name object.

scientificNamestring

The exact verbatim, full scientific name as given before parsing.

A coarse classification of names helping to deal with different syntactical name string structures.

genusOrAbovestring

The genus part of a bi/trinomial or the monomial in case of names of higher ranks.

infraGenericstring

The infrageneric part of a name, often given in parentheses between genus and species epithet, e.g. for a subgenus

specificEpithetstring

The specific epithet of the name

infraSpecificEpithetstring

The infraspecific part of a name.

cultivarEpithetstring

The cultivar, cultivar group or grex part of a cultivated plant name.

If given the name should be of type CULTIVAR

strainstring

The strain or isolate name. Usually a capital collection code string followed by an accession number.

See List of culture collection codes. If given the name should be of type STRAIN.

notho'GENERIC' | 'INFRAGENERIC' | 'SPECIFIC' | 'INFRASPECIFIC'

For hybrid names notho indicates which part of the name is considered a hybrid, i.e. genus, species or infraspecific epithet.

authorshipstring

The original author of this name, e.g. basionym or recombination author.

yearstring

The year of publication as given in the authorship.

bracketAuthorshipstring

The authorship of the original name, i.e. basionym, given in brackets.

bracketYearstring

The code relevant year of publication of the original name, i.e. basionym, given in brackets.

sensustring

Taxon concept references as part of the name, e.g. “MSW2006” for Gorilla gorilla (Savage, 1847) sec. MSW2005

parsedboolean

A flag indicating if a name could not be parsed at all.

If false, only the scientific name, rank and potentially the name type is given.

parsedPartiallyboolean

The GBIF name parser cannot always parse the entire name.

This is often the case when taxonomic, nomenclatural or identification notes are added to the end of the name. In such cases when the name was only partially parsed (NameUsageIssue.PARTIALLY_PARSABLE) this flag should be true.

If the name was not parsed at all this will be false.

nomStatusstring

Any nomenclatoral remarks given in this name, e.g. nom. illeg.

remarksstring

Any further remarks found.

canonicalNamestring

The canonical name sensu strictu with nothing else but three name parts at most (genus, species, infraspecific).

No rank or hybrid markers and no authorship, cultivar or strain information.

Infrageneric names are represented without a leading genus.

Unicode characters are replaced by their matching ASCII characters.

canonicalNameWithMarkerstring

The code-compliant, canonical name with three name parts at max (genus, species, infraspecific), a rank marker for infraspecific names and cultivar or strain epithets. The canonical name can be a 1, 2 or 3 parted name, but does not include any informal notes or authorships. Notho taxa will have the hybrid marker.

Unicode characters will be replaced by their matching ASCII characters.

canonicalNameCompletestring

The code-compliant, canonical name with rank and hybrid marker, authorship and cultivar or strain name included. Informal or nomenclatoral notes, concept references, subgenus and non-terminal authorships are removed.

The taxonomic rank of the name.