---
title: "GET /portfolio/{portfolioId}/portfolio_fields"
method: GET
path: "/portfolio/{portfolioId}/portfolio_fields"
tags: ["Portfolios"]
---

# GET /portfolio/{portfolioId}/portfolio_fields

`GET /portfolio/{portfolioId}/portfolio_fields`

## Request

- Base URL: `https://api.craft.io`
- URL: `https://api.craft.io/portfolio/{portfolioId}/portfolio_fields`
- Auth: API key in header `x-api-key`

Get the list of portfolio fields and their metadata

## Path parameters

- `portfolioId` string, required

## Query parameters

- `includeOptions` boolean

## Response `200`

A list of portfolio fields and their metadata

- CustomField[]
  - `id` string, required
  - `name` string, required
  - `type` string, required
  - `capacityEnabled` boolean: NUMBER fields only: true when the container plans capacity against this field. A capacity field (FE, BE) is otherwise indistinguishable from any other number (Reach, ACV) here. Read the limits with /capacity.
  - `categoryId` string, nullable
  - `categoryName` string, nullable
  - `values` string[]
  - `options` CustomFieldOption[]
    - `id` string, required
    - `label` string, required
    - `startDate` string, nullable
    - `endDate` string, nullable
  - `optionShape` 'select' | 'date' | 'date_range'
  - `multi` boolean
  - `source` 'portal' | 'workspace'

## Other responses

- `400`: Invalid portfolio ID
- `401`: No access to portfolio
- `403`: Access denied
- `500`: An error occurred while fetching portfolio fields

## Changes

- **2026-10-01** `6009bb084cb5`: 4 info
  - added the optional property `error` to the response with the `400` status
  - added the optional property `error` to the response with the `401` status
  - added the optional property `error` to the response with the `403` status
  - added the optional property `error` to the response with the `500` status
- **2026-09-15** `9388f8d7ecd8`: 1 info
  - added the optional property `items/capacityEnabled` to the response with the `200` status

[Operation history](https://skmtc.dev/craft/apis/craft-io-public-api/changes/portfolio/:portfolioId/portfolio_fields/get.md)

---

[API](https://skmtc.dev/craft/apis/craft-io-public-api.md) - [All operations](https://skmtc.dev/craft/apis/craft-io-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/craft/apis/craft-io-public-api/revisions/2972a1b05ab1?raw)