Portfolios

List a portfolio's custom fields

Returns every custom field the company has defined for portfolios, each carrying the value stored on this portfolio. Fields with no value here come back without a value.

GET

https://api.portal.magicdoor.com/company-app/portfolios/{portfolioId}/custom-fields

Authorization

Authorizationstringrequired

Bearer token — Send your API token in the Authorization header as Bearer <token>. Requests without a valid token are rejected with 401 Unauthorized.

Path parameters

portfolioIdstringrequired

Snowflake id of the portfolio, as a decimal string.

example: 1830472847398404096

Response

200 · The company's portfolio custom fields, with this portfolio's answers.

customFieldsobject[]

Every custom field the company has defined for this kind of record, each with the value stored for this particular record.

401 · The access token is missing, expired, or not for this company.

Request

curl --request GET \
  --url 'https://api.portal.magicdoor.com/company-app/portfolios/1830472847398404096/custom-fields' \
  --header 'Authorization: Bearer <token>'

Response

{
  "customFields": [
    {
      "id": "1830472847398404099",
      "name": "Roof warranty expires",
      "public": false,
      "filterable": true,
      "listable": false,
      "order": 1,
      "options": {
        "type": "datetime",
        "required": false,
        "componentType": "date",
        "dateOnly": true
      },
      "value": {
        "customFieldId": "1830472847398404099",
        "entityType": "portfolio",
        "entityId": "1830472847398404096",
        "dateTimeValue": "2029-04-30T00:00:00",
        "created": "2026-01-08T10:15:00",
        "updated": "2026-01-08T10:15:00"
      }
    }
  ]
}