---
title: "Name usage distributions by id"
method: GET
path: "/v1/species/{usageKey}/distributions"
tags: ["Species"]
---

# Name usage distributions by id

`GET /v1/species/{usageKey}/distributions`

Retrieves all distributions for a name usage.

## Path parameters

- `usageKey` integer, required

## Query parameters

- `arg1` Pageable, required
  - `offset` integer
  - `limit` integer
- `limit` integer
- `offset` integer

## Response `200`

Name usage distributions found

- PagingResponseDistribution
  - `offset` integer — The offset of the results within all the search results. Subsequent pages can be retrieved by using `offset + count` as the new offset.
  - `limit` integer — The limit used. Note the limit returned may be lower than the limit requested.
  - `endOfRecords` boolean — True if this page of search results is the final page.
  - `count` integer — The total number of records returned by the search.
  - `results` Distribution[] — Search results.
    - `taxonKey` integer — The name usage “taxon“ key to which this species profile belongs.
    - `locationId` string — A code for the named area this distributon record is about.
    - `locality` string — The verbatim name of the area this distribution record is about.
    - `country` 'AF' | 'AX' | 'AL' | 'DZ' | 'AS' | 'AD' | 'AO' | 'AI' | 'AQ' | 'AG' | 'AR' | 'AM' | 'AW' | 'AU' | 'AT' | 'AZ' | 'BS' | 'BH' | 'BD' | 'BB' | 'BY' | 'BE' | 'BZ' | 'BJ' | 'BM' | 'BT' | 'BO' | 'BQ' | 'BA' | 'BW' | 'BV' | 'BR' | 'IO' | 'BN' | 'BG' | 'BF' | 'BI' | 'KH' | 'CM' | 'CA' | 'CV' | 'KY' | 'CF' | 'TD' | 'CL' | 'CN' | 'CX' | 'CC' | 'CO' | 'KM' | 'CD' | 'CG' | 'CK' | 'CR' | 'CI' | 'HR' | 'CU' | 'CW' | 'CY' | 'CZ' | 'DK' | 'DJ' | 'DM' | 'DO' | 'EC' | 'EG' | 'SV' | 'GQ' | 'ER' | 'EE' | 'ET' | 'FK' | 'FO' | 'FJ' | 'FI' | 'FR' | 'GF' | 'PF' | 'TF' | 'GA' | 'GM' | 'GE' | 'DE' | 'GH' | 'GI' | 'GR' | 'GL' | 'GD' | 'GP' | 'GU' | 'GT' | 'GG' | 'GN' | 'GW' | 'GY' | 'HT' | 'HM' | 'VA' | 'HN' | 'HK' | 'HU' | 'IS' | 'IN' | 'ID' | 'IR' | 'IQ' | 'IE' | 'IM' | 'IL' | 'IT' | 'JM' | 'JP' | 'JE' | 'JO' | 'KZ' | 'KE' | 'KI' | 'KP' | 'KR' | 'KW' | 'KG' | 'LA' | 'LV' | 'LB' | 'LS' | 'LR' | 'LY' | 'LI' | 'LT' | 'LU' | 'MO' | 'MK' | 'MG' | 'MW' | 'MY' | 'MV' | 'ML' | 'MT' | 'MH' | 'MQ' | 'MR' | 'MU' | 'YT' | 'MX' | 'FM' | 'MD' | 'MC' | 'MN' | 'ME' | 'MS' | 'MA' | 'MZ' | 'MM' | 'NA' | 'NR' | 'NP' | 'NL' | 'NC' | 'NZ' | 'NI' | 'NE' | 'NG' | 'NU' | 'NF' | 'MP' | 'NO' | 'OM' | 'PK' | 'PW' | 'PS' | 'PA' | 'PG' | 'PY' | 'PE' | 'PH' | 'PN' | 'PL' | 'PT' | 'PR' | 'QA' | 'RE' | 'RO' | 'RU' | 'RW' | 'BL' | 'SH' | 'KN' | 'LC' | 'MF' | 'PM' | 'VC' | 'WS' | 'SM' | 'ST' | 'SA' | 'SN' | 'RS' | 'SC' | 'SL' | 'SG' | 'SX' | 'SK' | 'SI' | 'SB' | 'SO' | 'ZA' | 'GS' | 'SS' | 'ES' | 'LK' | 'SD' | 'SR' | 'SJ' | 'SZ' | 'SE' | 'CH' | 'SY' | 'TW' | 'TJ' | 'TZ' | 'TH' | 'TL' | 'TG' | 'TK' | 'TO' | 'TT' | 'TN' | 'TR' | 'TM' | 'TC' | 'TV' | 'UG' | 'UA' | 'AE' | 'GB' | 'US' | 'UM' | 'UY' | 'UZ' | 'VU' | 'VE' | 'VN' | 'VG' | 'VI' | 'WF' | 'EH' | 'YE' | 'ZM' | 'ZW' | 'AA' | 'XK' | 'XZ' | 'ZZ' — The country
    - `status` 'PRESENT' | 'COMMON' | 'RARE' | 'IRREGULAR' | 'DOUBTFUL' | 'EXCLUDED' | 'ABSENT' — Term describing the occurrence status of the organism in the given area based on how frequent the species occurs.
    - `lifeStage` 'ZYGOTE' | 'EMRYO' | 'LARVA' | 'JUVENILE' | 'ADULT' | 'SPOROPHYTE' | 'SPORE' | 'GAMETOPHYTE' | 'GAMETE' | 'PUPA' — The distribution information pertains solely to a specific life stage of the taxon.
    - `temporal` string — Relevant temporal context for this entire distribution record including all properties, preferably given as a year range or single year on which the distribution record is valid. For the same area and taxon there could therefore be several records with different temporal context, e.g. in 5-year intervals for invasive species.
    - `threatStatus` 'EXTINCT' | 'EXTINCT_IN_THE_WILD' | 'REGIONALLY_EXTINCT' | 'CRITICALLY_ENDANGERED' | 'ENDANGERED' | 'VULNERABLE' | 'NEAR_THREATENED' | 'LEAST_CONCERN' | 'DATA_DEFICIENT' | 'NOT_APPLICABLE' | 'NOT_EVALUATED' — Threat status of a species as defined by IUCN.
    - `establishmentMeans` 'NATIVE' | 'INTRODUCED' | 'NATURALISED' | 'INVASIVE' | 'MANAGED' | 'UNCERTAIN' — Term describing whether the organism occurs natively, is introduced or cultivated.
    - `appendixCites` 'I' | 'II' | 'III' — The CITES (Convention on International Trade in Endangered Species of Wild Fauna and Flora) Appendix number under which the taxon is listed. It is possible to have different appendix numbers for different areas, but “global” as an area is also valid.
    - `source` string — Bibliographic citation referencing a source for the distribution.
    - `sourceTaxonKey` integer — The name usage key of the taxon in the checklist including this distribution.
    - `startDayOfYear` integer — Seasonal temporal subcontext within the eventDate context. Useful for migratory species. The earliest ordinal day of the year on which the distribution record is valid. Numbering starts with 1 for 1 January and ends with 365 or 366 for 31 December.
    - `endDayOfYear` integer — Seasonal temporal subcontext within the eventDate context. The latest ordinal day of the year on which the distribution record is valid.
    - `remarks` string — Additional notes on the distribution.

## Other responses

- `400` — Invalid query
- `404` — Name usage not found

---

[API](https://skmtc.net/gbif/apis/species-api.md) · [All operations](https://skmtc.net/gbif/apis/species-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gbif/species-api/revisions/03ccf35f8dd9/schema)