GBgbif
Species

Name usage by id

Changed on

Retrieves a single name usage.

get/v1/species/{usageKey}

Request

Path parameters

usageKeyinteger required

Name usage key.

Headers

Accept-Language'abk' | 'aar' | 'afr' | 'aka' | 'sqi' | 'amh' | 'ara' | 'arg' | 'hye' | 'asm' | 'ava' | 'ave' | 'aym' | 'aze' | 'bam' | 'bak' | 'eus' | 'bel' | 'ben' | 'bih' | 'bis' | 'bos' | 'bre' | 'bul' | 'mya' | 'cat' | 'cha' | 'che' | 'zho' | 'chu' | 'chv' | 'cor' | 'cos' | 'cre' | 'hrv' | 'ces' | 'dan' | 'div' | 'nld' | 'dzo' | 'eng' | 'epo' | 'est' | 'ewe' | 'fao' | 'fij' | 'fin' | 'fra' | 'fry' | 'ful' | 'glg' | 'lug' | 'kat' | 'deu' | 'ell' | 'kal' | 'grn' | 'guj' | 'hat' | 'hau' | 'heb' | 'her' | 'hin' | 'hmo' | 'hun' | 'isl' | 'ido' | 'ibo' | 'ind' | 'ina' | 'ile' | 'iku' | 'ipk' | 'gle' | 'ita' | 'jpn' | 'jav' | 'kan' | 'kau' | 'kas' | 'kaz' | 'khm' | 'kik' | 'kin' | 'kir' | 'kom' | 'kon' | 'kor' | 'kur' | 'kua' | 'lao' | 'lat' | 'lav' | 'lim' | 'lin' | 'lit' | 'lub' | 'ltz' | 'mkd' | 'mlg' | 'msa' | 'mal' | 'mlt' | 'glv' | 'mri' | 'mar' | 'mah' | 'mol' | 'mon' | 'nau' | 'nav' | 'ndo' | 'nep' | 'nde' | 'sme' | 'nob' | 'nno' | 'nor' | 'nya' | 'oci' | 'oji' | 'ori' | 'orm' | 'oss' | 'pli' | 'pan' | 'fas' | 'pol' | 'por' | 'pus' | 'que' | 'roh' | 'ron' | 'run' | 'rus' | 'smo' | 'sag' | 'san' | 'srd' | 'gla' | 'srp' | 'sna' | 'iii' | 'snd' | 'sin' | 'slk' | 'slv' | 'som' | 'nbl' | 'sot' | 'spa' | 'sun' | 'swa' | 'ssw' | 'swe' | 'tgl' | 'tah' | 'tgk' | 'tam' | 'tat' | 'tel' | 'tha' | 'bod' | 'tir' | 'ton' | 'tso' | 'tsn' | 'tur' | 'tuk' | 'twi' | 'uig' | 'ukr' | 'urd' | 'uzb' | 'ven' | 'vie' | 'vol' | 'wln' | 'cym' | 'wol' | 'xho' | 'yid' | 'yor' | 'zha' | 'zul' | ''

Language for vernacular names, given as an ISO 639-1 two-letter code from our vocabulary.

Response

Name usage found

keyinteger

The name usage key that uniquely identifies this name usage.

nubKeyinteger

The taxon key of the matching backbone name usage.

If this is equal to key, this name usage is a backbone name usage.

nameKeyinteger

The key for retrieving a parsed name object.

You are more likely to need the key or nubKey properties

taxonIDstring

The original taxonID of the name usage as found in the source.

For backbone taxa and name usages with an origin different to SOURCE this is null.

sourceTaxonKeyinteger

The key of the name usage from which this backbone taxon derives.

For backbone taxa the source taxon key refers to the original name usage that was used during backbone building and is the primary reason that this taxon exists in the backbone.

All backbone name usages are built from several underlying checklist usages, but these are sorted by priority and the usage key for the highest priority one becomes the sourceTaxonKey for a backbone usage.

Some backbone usages do not have any source record at all; for example if there is a subspecies found, but no matching parent species, the missing species will be created nevertheless and has no primary source.

kingdomstring

Kingdom.

phylumstring

Phylum.

orderstring

Order.

familystring

Family.

genusstring

Genus.

subgenusstring

Subgenus.

speciesstring

Species.

kingdomKeyinteger

Name usage key of the kingdom.

phylumKeyinteger

Name usage key of the phylum.

classKeyinteger

Name usage key of the class.

orderKeyinteger

Name usage key of the order.

familyKeyinteger

Name usage key of the family.

genusKeyinteger

Name usage key of the genus.

subgenusKeyinteger

Name usage key of the subgenus.

speciesKeyinteger

Name usage key of the species.

datasetKeystring uuid

The checklist that “hosts” this name usage.

For a backbone name usage, this will be d7dddbf4-2cf0-4f39-9b2a-bb099caae36c.

constituentKeystring uuid

The optional sub-dataset key for this usage.

parentKeyinteger

The name usage key of the immediate parent. Null for the highest taxonomic level.

parentstring

The scientific name of the parent.

proParteKeyinteger

The primary name usage key for a pro parte synonym.

Synonyms with multiple accepted names are grouped by a single, primary name usage key.

acceptedKeyinteger

The name usage key of the accepted name.

acceptedstring

The scientific name of the accepted name.

basionymKeyinteger

The name usage key of the basionym.

basionymstring

The scientific name of the basionym.

scientificNamestring

The scientific name, with date and authorship information if available.

Examples: Coleoptera (order), Vespertilionidae (family), Manis (genus), Ctenomys sociabilis (genus + specificEpithet), Ambystoma tigrinum diaboli (zoology, genus + specific name + infraspecific name) Quercus agrifolia var. oxyadenia (Torr.) (botany, genus + specific epithet + infraspecific epithet + authorship)

canonicalNamestring

The canonical name; the name without authorship or references.

vernacularNamestring

A common or vernacular name for this usage.

authorshipstring

The authorship for the scientific name.

nameType'SCIENTIFIC' | 'VIRUS' | 'HYBRID' | 'INFORMAL' | 'CULTIVAR' | 'CANDIDATUS' | 'OTU' | 'DOUBTFUL' | 'PLACEHOLDER' | 'NO_NAME' | 'BLACKLISTED'

The type of name string classified by Checklistbank.

rank'DOMAIN' | 'SUPERKINGDOM' | 'KINGDOM' | 'SUBKINGDOM' | 'INFRAKINGDOM' | 'SUPERPHYLUM' | 'PHYLUM' | 'SUBPHYLUM' | 'INFRAPHYLUM' | 'SUPERCLASS' | 'CLASS' | 'SUBCLASS' | 'INFRACLASS' | 'PARVCLASS' | 'SUPERLEGION' | 'LEGION' | 'SUBLEGION' | 'INFRALEGION' | 'SUPERCOHORT' | 'COHORT' | 'SUBCOHORT' | 'INFRACOHORT' | 'MAGNORDER' | 'SUPERORDER' | 'GRANDORDER' | 'ORDER' | 'SUBORDER' | 'INFRAORDER' | 'PARVORDER' | 'SUPERFAMILY' | 'FAMILY' | 'SUBFAMILY' | 'INFRAFAMILY' | 'SUPERTRIBE' | 'TRIBE' | 'SUBTRIBE' | 'INFRATRIBE' | 'SUPRAGENERIC_NAME' | 'GENUS' | 'SUBGENUS' | 'INFRAGENUS' | 'SECTION' | 'SUBSECTION' | 'SERIES' | 'SUBSERIES' | 'INFRAGENERIC_NAME' | 'SPECIES_AGGREGATE' | 'SPECIES' | 'INFRASPECIFIC_NAME' | 'GREX' | 'SUBSPECIES' | 'CULTIVAR_GROUP' | 'CONVARIETY' | 'INFRASUBSPECIFIC_NAME' | 'PROLES' | 'RACE' | 'NATIO' | 'ABERRATION' | 'MORPH' | 'VARIETY' | 'SUBVARIETY' | 'FORM' | 'SUBFORM' | 'PATHOVAR' | 'BIOVAR' | 'CHEMOVAR' | 'MORPHOVAR' | 'PHAGOVAR' | 'SEROVAR' | 'CHEMOFORM' | 'FORMA_SPECIALIS' | 'CULTIVAR' | 'STRAIN' | 'OTHER' | 'UNRANKED'

The rank for this usage.

origin'SOURCE' | 'DENORMED_CLASSIFICATION' | 'VERBATIM_PARENT' | 'VERBATIM_ACCEPTED' | 'VERBATIM_BASIONYM' | 'PROPARTE' | 'AUTONYM' | 'IMPLICIT_NAME' | 'MISSING_ACCEPTED' | 'BASIONYM_PLACEHOLDER' | 'EX_AUTHOR_SYNONYM' | 'OTHER'

The name usage origin.

The origin of this name usage record, the reason it exists.

In most cases this is because the record existed explicitly in the checklist sources, but some usages are created de novo because the exist implicitly in the data.

taxonomicStatus'ACCEPTED' | 'DOUBTFUL' | 'SYNONYM' | 'HETEROTYPIC_SYNONYM' | 'HOMOTYPIC_SYNONYM' | 'PROPARTE_SYNONYM' | 'MISAPPLIED'

The taxonomic status of the name usage.

Can be null, but for all synonyms with an accepted name usage it is guaranteed to exist.

nomenclaturalStatusstring[]

The nomenclatural statuses of this name usage.

remarksstring

Remarks on the name usage.

publishedInstring

Original publication for this name usage.

accordingTostring

The taxon concept reference.

This is usually a reference to some publication or an author and year.

The Darwin Core taxonAccordingTo reference is usually appended to the scientific name to further qualify the concept with “sensu” or “sec.” being used for concatenation; for example “Acer nigrum sec. Gleason Cronquist 1991”.

In the case of backbone taxa, this refers to the primary checklist in which the name was found.

numDescendantsinteger

A total count of all accepted taxonomic elements under this usage.

referencesstring uri

A URI link or reference to the source of the record, the record's “homepage”.

modifiedstring date-time

The interpreted dc:modified from the verbatim source data, ideally indicating when a record was last modified in the source.

deletedstring date-time

The date this record was deleted.

Only backbone name usages are soft-deleted.

lastCrawledstring date-time

The date this record was last crawled (downloaded from the source) during Checklistbank indexing.

lastInterpretedstring date-time

The date this record was last interpreted during indexing. This includes matching to the backbone.

issuesstring[]

Data quality issues found during Checklistbank interpretation.

classstring

Class.

Changes

  • 03ccf35f8dd9Revision changes
    • breaking

      the response property became optional for the status (media type: application/json)

    • breaking

      the response property became optional for the status (media type: application/x-javascript)

    • breaking

      the response property became optional for the status (media type: application/json)

    • breaking

      the response property became optional for the status (media type: application/x-javascript)

    • breaking

      the response property became optional for the status (media type: application/json)

    • breaking

      the response property became optional for the status (media type: application/x-javascript)

    • breaking

      the response property became optional for the status (media type: application/json)

    • breaking

      the response property became optional for the status (media type: application/x-javascript)

    • breaking

      the response property became optional for the status (media type: application/json)

    • breaking

      the response property became optional for the status (media type: application/x-javascript)

    • warning

      for the path request parameter usageKey, the min was set to 0.00