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

# Name usage species profiles by id

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

Retrieves all species profiles for a name usage.

Species profiles describe basic species characteristics.

## Path parameters

- `usageKey` integer, required

## Query parameters

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

## Response `200`

Name usage species profiles found

- PagingResponseSpeciesProfile
  - `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` SpeciesProfile[] — Search results.
    - `taxonKey` integer — The name usage “taxon“ key to which this species profile belongs.
    - `livingPeriod` string — The geological time a currently extinct organism is known to have lived.
    - `lifeForm` string — A term describing the growth/lifeform of an organism. See [Life Form vocabulary](https://rs.gbif.org/vocabulary/gbif/life_form).
    - `habitat` string — Comma-separated list of major habitat classifications as defined by the IUCN in which a species is known to exist. See [Habitats vocabulary](https://rs.gbif.org/vocabulary/iucn/habitat/).
    - `marine` boolean — A Boolean flag indicating whether the taxon is a marine organism, i.e. can be found in/above sea water.
    - `freshwater` boolean — Flag indicating whether the taxon is a freshwater organism.
    - `terrestrial` boolean — A Boolean flag indicating the taxon is a terrestrial organism, i.e. occurs on land as opposed to the sea.
    - `extinct` boolean — Flag indicating an extinct organism.
    - `hybrid` boolean — Flag indicating a hybrid organism.
    - `ageInDays` integer — Maximum observed age of an organism given as number of days.
    - `sizeInMillimeter` integer — Maximum observed size of an organism in millimetres. Can be either height, length or width, whichever is greater.
    - `massInGram` integer — Maximum observed weight of an organism in grams.
    - `source` string — Bibliographic citation referencing a source for the species profile.
    - `sourceTaxonKey` integer — The name usage key of the taxon in the checklist including this species profile.

## 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)