---
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`

## Request

- Base URL: `https://api.gbif.org`
- URL: `https://api.gbif.org/v1/species/{usageKey}/speciesProfiles`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gbif/apis/species-api/docs/v1/species/:usageKey/speciesProfiles/get.ts> (a function with typed inputs; its response is checked against the schema)

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

## Changes

- **2026-08-20** `03ccf35f8dd9`: 1 breaking, 3 warning
  - added the new required `query` request parameter `arg1`
  - for the `path` request parameter `usageKey`, the min was set to `0.00`
  - for the `query` request parameter `limit`, the min was set to `0.00`
  - for the `query` request parameter `offset`, the min was set to `0.00`

[Operation history](https://skmtc.dev/gbif/apis/species-api/changes/v1/species/:usageKey/speciesProfiles/get.md)

---

[API](https://skmtc.dev/gbif/apis/species-api.md) - [All operations](https://skmtc.dev/gbif/apis/species-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gbif/apis/species-api/revisions/03ccf35f8dd9?raw)