---
title: "Private account institution group custom fields"
method: GET
path: "/account/institution/custom_fields"
tags: ["institutions"]
---

# Private account institution group custom fields

`GET /account/institution/custom_fields`

Returns the custom fields in the group the user belongs to, or the ones in the group specified, if the user has access. Deprecated in favour of GET /account/items/fields/configuration/{item_type_id}. Will be removed after 2027-01-01.

## Query parameters

- `group_id` integer

## Response `200`

OK. An array of custom fields

- ShortCustomField[]
  - `id` integer, required — Custom field id
  - `name` string, required — Custom field name
  - `field_type` 'text' | 'textarea' | 'dropdown' | 'url' | 'email' | 'date' | 'dropdown_large_list', required — Custom field type
  - `settings` object — Settings for the custom field
  - `order` integer — Order of the field in the group
  - `is_mandatory` boolean — Whether the field is mandatory or not

## Other responses

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

---

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