---
title: "List custom field definitions"
method: GET
path: "/cohorts/{cohortId}/custom-fields"
tags: ["Custom Fields"]
---

# List custom field definitions

`GET /cohorts/{cohortId}/custom-fields`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/cohorts/{cohortId}/custom-fields`
- Auth: HTTP bearer

Get all custom field definitions for a cohort

## Path parameters

- `cohortId` string, uuid, required

## Response `200`

Custom fields retrieved successfully

- object
  - `success` boolean
  - `data` object[]
    - `id` string, uuid
    - `cohort_id` string, uuid
    - `field_name` string
    - `field_label` string
    - `field_type` 'text' | 'number' | 'date' | 'boolean'
    - `sort_order` integer

## Other responses

- `401`: Unauthorized
- `404`: Cohort not found

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)