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

# Name usage identifiers by id

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

Retrieves all identifiers for a name usage.

## Path parameters

- `usageKey` integer, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Name usage identifiers found

- PagingResponseIdentifier
  - `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` Identifier[] — Search results.
    - `identifier` string, required — Other known identifier used for the same taxon. Can be a URL pointing to a webpage, an XML or RDF document, a DOI UUID or any other identifier.
    - `title` string — The optional title of an identifier, mostly for linking.
    - `type` 'URL' | 'LSID' | 'HANDLER' | 'DOI' | 'UUID' | 'FTP' | 'URI' | 'UNKNOWN' | 'GBIF_PORTAL' | 'GBIF_NODE' | 'GBIF_PARTICIPANT' | 'GRSCICOLL_ID' | 'GRSCICOLL_URI' | 'IH_IRN' | 'ROR' | 'GRID' | 'CITES' | 'SYMBIOTA_UUID' | 'WIKIDATA' | 'NCBI_BIOCOLLECTION' | 'ISIL' | 'CLB_DATASET_KEY', required — Type of identifier.
    - `identifierLink` string — An HTTP link for an identifier, if a suitable, known resolver exists for the identifier type.

## 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/versions/156fd5bac927/schema)