---
title: "Item Types"
method: GET
path: "/item_types"
tags: ["other"]
---

# Item Types

`GET /item_types`

Returns the list of Item Types of the requested group. If no user is authenticated, returns the item types available for Figshare.

## Query parameters

- `group_id` integer

## Response `200`

OK. An array of item types

- ItemType[]
  - `id` integer, required — The ID of the item type.
  - `name` string, required — The name of the item type
  - `string_id` string, required — The string identifier of the item type.
  - `icon` string, required — The string identifying the icon of the item type.
  - `public_description` string, required — The description of the item type.
  - `is_selectable` boolean, required — The selectable status
  - `url_name` string, required — The URL name of the item type.
  - `fields` ItemTypeField[] — Available metadata fields for this item type. Only present when item-type based metadata is enabled for the institution. Use GET /account/items/fields/configuration/{item_type_id} for full detail.
    - `id` integer — Underlying field unique identifier
    - `name` string — Field name
    - `field_type` string — Field type
    - `internal_type` 'core' | 'stock' | 'custom' — Internal type: core, stock, or custom
    - `display_name` string — Display name configured for this item type
    - `hint_text` string — Hint text shown to the user
    - `is_mandatory` boolean — Whether this field is mandatory for this item type
    - `order` integer — Display order within the item type
    - `display_area` 'additional' | 'core' | 'essential' | 'timeline' — UI display area
    - `settings` object — Per-item-type field settings (may include default_value, validations)

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `404` — Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.dev/figshare/apis/figshare-api.md) · [All operations](https://skmtc.dev/figshare/apis/figshare-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/figshare/figshare-api/revisions/9dfb419f4430/schema)