Leases

List a lease's custom fields

Returns every custom field the company has defined for leases, each with its definition and this lease's value if one has been set. Fields with no value still appear, with value absent.

GET

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

leaseIdstringrequired

The lease whose custom-field values you want. A Snowflake id, sent as a decimal string.

example: 1830472847398404096

Response

200 · The custom fields and their values on this lease.

customFieldsEntityCustomField[]

One entry per custom field defined for leases.

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

404 · No lease matched the id, or it belongs to another company.

Request

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

Response

{
  "customFields": [
    {
      "id": "1851019384756201984",
      "name": "Parking space",
      "public": false,
      "filterable": true,
      "listable": true,
      "order": 1,
      "options": {
        "type": "string",
        "required": false,
        "componentType": "input"
      },
      "value": {
        "customFieldId": "1851019384756201984",
        "entityType": "lease",
        "entityId": "1830472847398404096",
        "stringValue": "P-14",
        "created": "2026-03-02T11:00:00",
        "updated": "2026-03-02T11:00:00"
      }
    }
  ]
}