Units

List a unit's custom fields

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

GET

https://api.portal.magicdoor.com/company-app/units/{unitId}/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

unitIdstringrequired

Snowflake id of the unit, as a decimal string.

example: 1830472847398404098

Response

200 · The company's unit custom fields, with this unit'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/units/1830472847398404098/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": "unit",
        "entityId": "1830472847398404098",
        "dateTimeValue": "2029-04-30T00:00:00",
        "created": "2026-01-08T10:15:00",
        "updated": "2026-01-08T10:15:00"
      }
    }
  ]
}