GBgbif
Species

Name usage distributions by id

Changed on

Retrieves all distributions for a name usage.

get/v1/species/{usageKey}/distributions

Request

Path parameters

usageKeyinteger required

Name usage key.

Query parameters

offsetinteger
limitinteger
limitinteger

Controls the number of results in the page. Using too high a value will be overwritten with the default maximum threshold, depending on the service. Sensible defaults are used so this may be omitted.

offsetinteger

Determines the offset for the search results. A limit of 20 and offset of 40 will get the third page of 20 results. Some services have a maximum offset.

Response

Name usage distributions found

offsetinteger

The offset of the results within all the search results.

Subsequent pages can be retrieved by using offset + count as the new offset.

limitinteger

The limit used. Note the limit returned may be lower than the limit requested.

endOfRecordsboolean

True if this page of search results is the final page.

countinteger

The total number of records returned by the search.

Changes

  • 03ccf35f8dd9Revision changes
    • breaking

      added the new required query request parameter arg1

    • warning

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

    • warning

      for the query request parameter limit, the min was set to 0.00

    • warning

      for the query request parameter offset, the min was set to 0.00