---
title: "GET /crm-object-schemas/2026-09/schemas"
method: GET
path: "/crm-object-schemas/2026-09/schemas"
tags: ["Basic"]
---

# GET /crm-object-schemas/2026-09/schemas

`GET /crm-object-schemas/2026-09/schemas`

## Query parameters

- `archived` boolean
- `includeAssociationDefinitions` boolean
- `includeAuditMetadata` boolean
- `includePropertyDefinitions` boolean

## Response `200`

successful operation

- CollectionResponseObjectSchemaNoPaging
  - `results` ObjectSchema[], required
    - `allowsSensitiveProperties` boolean, required
    - `archived` boolean, required
    - `associations` AssociationDefinition[], required — Associations defined for a given object type.
      - `createdAt` string, date-time — When the association was defined.
      - `fromObjectTypeId` string, required — ID of the primary object type to link from.
      - `id` string, required — A unique ID for this association.
      - `name` string — A unique name for this association.
      - `toObjectTypeId` string, required — ID of the target object type to link to.
      - `updatedAt` string, date-time — When the association was last updated.
    - `createdAt` string, date-time — When the object schema was created.
    - `createdByUserId` integer
    - `description` string
    - `fullyQualifiedName` string, required — An assigned unique ID for the object, including portal ID and object name.
    - `id` string, required — A unique ID for this schema's object type. Will be defined as {meta-type}-{unique ID}.
    - `labels` ObjectTypeDefinitionLabels, required
      - `plural` string — The word for multiple objects. (There’s no way to change this later.)
      - `singular` string — The word for one object. (There’s no way to change this later.)
    - `name` string, required — A unique name for the schema's object type.
    - `objectTypeId` string, required
    - `primaryDisplayProperty` string — The name of the primary property for this object. This will be displayed as primary on the HubSpot record page for this object type.
    - `properties` Property[], required — Properties defined for this object type.
      - `archived` boolean — Whether or not the property is archived.
      - `archivedAt` string, date-time — When the property was archived.
      - `calculated` boolean — For default properties, true indicates that the property is calculated by a HubSpot process. It has no effect for custom properties.
      - `calculationFormula` string — The formula used for calculated properties.
      - `createdAt` string, date-time — When the property was created
      - `createdUserId` string — The internal ID of the user who created the property in HubSpot. This field may not exist if the property was created outside of HubSpot.
      - `dataSensitivity` 'highly_sensitive' | 'non_sensitive' | 'sensitive' — Indicates the sensitivity level of the property, such as "non_sensitive", "sensitive", or "highly_sensitive".
      - `dateDisplayHint` 'absolute' | 'absolute_with_relative' | 'time_since' | 'time_until'
      - `description` string, required — A description of the property that will be shown as help text in HubSpot.
      - `displayOrder` integer — The order that this property should be displayed in the HubSpot UI relative to other properties for this object type. Properties are displayed in order starting with the lowest positive integer value. A value of -1 will cause the property to be displayed **after** any positive values.
      - `externalOptions` boolean — For default properties, true indicates that the options are stored externally to the property settings.
      - `fieldType` string, required — Controls how the property appears in HubSpot.
      - `formField` boolean — Whether or not the property can be used in a HubSpot form.
      - `groupName` string, required — The name of the property group the property belongs to.
      - `hasUniqueValue` boolean — Whether or not the property's value must be unique. Once set, this can't be changed.
      - `hidden` boolean — Whether or not the property will be hidden from the HubSpot UI. It's recommended that this be set to false for custom properties.
      - `hubspotDefined` boolean — This will be true for default object properties built into HubSpot.
      - `label` string, required — A human-readable property label that will be shown in HubSpot.
      - `modificationMetadata` PropertyModificationMetadata
        - `archivable` boolean, required
        - `readOnlyDefinition` boolean, required
        - `readOnlyOptions` boolean
        - `readOnlyValue` boolean, required
      - `name` string, required — The internal property name, which must be used when referencing the property via the API.
      - `options` Option[], required — A list of valid options for the property. This field is required for enumerated properties, but will be empty for other property types.
        - `description` string — A description of the option.
        - `displayOrder` integer — Options are displayed in order starting with the lowest positive integer value. Values of -1 will cause the option to be displayed after any positive values.
        - `hidden` boolean, required — Hidden options will not be displayed in HubSpot.
        - `label` string, required — A human-readable option label that will be shown in HubSpot.
        - `value` string, required — The internal value of the option, which must be used when setting the property value through the API.
      - `referencedObjectType` string — If this property is related to other object(s), they'll be listed here.
      - `sensitiveDataCategories` string[] — When sensitiveData is true, lists the type of sensitive data contained in the property (e.g., "HIPAA").
      - `showCurrencySymbol` boolean — Whether the property will display the currency symbol set in the account settings.
      - `type` string, required — The property data type.
      - `updatedAt` string, date-time — The timestamp when the property was last updated, in ISO 8601 format.
      - `updatedUserId` string — The internal user ID of the user who updated the property in HubSpot. This field may not exist if the property was updated outside of HubSpot.
    - `requiredProperties` string[], required — The names of properties that should be **required** when creating an object of this type.
    - `searchableProperties` string[], required — Names of properties that will be indexed for this object type in by HubSpot's product search.
    - `secondaryDisplayProperties` string[], required — The names of secondary properties for this object. These will be displayed as secondary on the HubSpot record page for this object type.
    - `updatedAt` string, date-time — When the object schema was last updated.
    - `updatedByUserId` integer

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/hubspot/apis/crm-schemas.md) · [All operations](https://skmtc.net/hubspot/apis/crm-schemas/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hubspot/crm-schemas/revisions/19ab6cb7793b/schema)