Get Object Schema by key / id

GET 
/objects/:key

Retrieve Object Schema by key or ID. This will return the schema of the custom object, including all its fields and properties. Supported objects include contact, opportunity, business and custom objects.To understand objects and records, please have a look the documentation here : https://doc.clickup.com/8631005/d/h/87cpx-277156/93bf0c2e23177b0

Request

Version stringrequired

API Version

Available options2023-02-21

key stringrequired

key of the custom or standard object. For custom objects, the key must include the prefix “custom_objects.”. This key can be found on the Object Details page under Settings in the UI.

locationId stringrequired

location id of the sub account

fetchProperties string

Fetch Properties , Fetches all the standard / custom fields of the object when set to true

application/json

Successful response

application/json

Schema

Schema

objectobject

The custom or standard object schema

cachebooleanrequired

Is the response served from cache

fieldsobject[]

Custom fields associated with the object schema

Example (auto)

{
  "object": {
    "id": "661c06b4ffde146bdb469442",
    "standard": false,
    "key": "custom_objects.pet",
    "labels": {
      "singular": "Pet",
      "plural": "Pets"
    },
    "description": "These are non vaccinated pets",
    "locationId": "ve9EPM428h8vShlRW1KT",
    "primaryDisplayProperty": "custom_objects.pet.name",
    "type": "USER_DEFINED",
    "dateAdded": "2025-01-02T09:35:39.032Z",
    "dateUpdated": "2025-01-02T09:35:39.032Z"
  },
  "cache": true,
  "fields": [
    {
      "id": "661c06b4ffde146bdb469442",
      "locationId": "ve9EPM428h8vShlRW1KT",
      "name": "Pet Name",
      "description": "Pet name field",
      "placeholder": "Enter pet name",
      "fieldKey": "custom_object.pet.name",
      "objectKey": "custom_object.pet",
      "originId": "661c06b4ffde146bdb469442",
      "dataType": "TEXT",
      "parentId": "3v34PM428h8vShlRW1KT",
      "showInForms": true,
      "allowCustomOption": true,
      "maxFileLimit": 2,
      "acceptedFormats": [
        ".pdf",
        ".jpg"
      ],
      "optionDisplayType": "TEXT_ONLY",
      "options": [
        {
          "key": "option_a",
          "label": "Option A",
          "url": "https://example.com"
        }
      ],
      "urlValidation": {
        "mode": "allow_all",
        "allowedDomains": [
          "example.com"
        ],
        "blockedDomains": []
      },
      "dateTimeValidation": {
        "mode": "range",
        "rangeMin": "2025-01-02",
        "rangeMax": "2025-12-31"
      },
      "userFieldConfig": {
        "multiSelect": false
      },
      "scopes": [
        {
          "scopeType": "list",
          "scopeId": "661c06b4ffde146bdb469442"
        }
      ],
      "dateAdded": "2025-01-02T09:35:39.032Z",
      "dateUpdated": "2025-01-02T09:35:39.032Z"
    }
  ]
}