Retrieve a validation rule for a specific property and rule type, providing details on how property values should be formatted.

curl --request GET \
  --url https://api.hubapi.com/crm/v3/property-validations/{objectTypeId}/{propertyName}/rule-type/{ruleType} \
  --header 'Authorization: Bearer <token>'

{
  "ruleArguments": [
    "<string>"
  ],
  "ruleType": "AFTER_DATETIME_DURATION",
  "shouldApplyNormalization": true
}

GET

crm

property-validations

{objectTypeId}

{propertyName}

rule-type

{ruleType}

Retrieve a validation rule for a specific property and rule type, providing details on how property values should be formatted.

curl --request GET \
  --url https://api.hubapi.com/crm/v3/property-validations/{objectTypeId}/{propertyName}/rule-type/{ruleType} \
  --header 'Authorization: Bearer <token>'

{
  "ruleArguments": [
    "<string>"
  ],
  "ruleType": "AFTER_DATETIME_DURATION",
  "shouldApplyNormalization": true
}

Supported products

Requires one of the following products or higher.

Marketing Hub -Free

Sales Hub -Free

Service Hub -Free

Content Hub -Free

Data Hub -Free

Required Scopes

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

objectTypeId

string

required

The ID of the object type to which the property belongs.

propertyName

string

required

The name of the property for which the validation rule is being retrieved.

ruleType

enum<string>

required

The type of validation rule being retrieved, such as FORMAT, ALPHANUMERIC, or MAX_LENGTH.

Available options:

AFTER_DATETIME_DURATION,

AFTER_DURATION,

ALPHANUMERIC,

BEFORE_DATETIME_DURATION,

BEFORE_DURATION,

DAYS_OF_WEEK,

DECIMAL,

DOMAIN,

EMAIL,

EMAIL_ALLOWED_DOMAINS,

EMAIL_BLOCKED_DOMAINS,

END_DATE,

END_DATETIME,

FORMAT,

MAX_LENGTH,

MAX_NUMBER,

MIN_LENGTH,

MIN_NUMBER,

PHONE_NUMBER_WITH_EXPLICIT_COUNTRY_CODE,

REGEX,

SPECIAL_CHARACTERS,

START_DATE,

START_DATETIME,

URL,

URL_ALLOWED_DOMAINS,

URL_BLOCKED_DOMAINS,

WHITESPACE

Response

successful operation

ruleArguments

string[]

required

A list of arguments that define the specific conditions or parameters for the validation rule.

ruleType

enum<string>

required

The category of validation applied to the property, such as FORMAT, ALPHANUMERIC, or MAX_LENGTH.

Available options:

AFTER_DATETIME_DURATION,

AFTER_DURATION,

ALPHANUMERIC,

BEFORE_DATETIME_DURATION,

BEFORE_DURATION,

DAYS_OF_WEEK,

DECIMAL,

DOMAIN,

EMAIL,

EMAIL_ALLOWED_DOMAINS,

EMAIL_BLOCKED_DOMAINS,

END_DATE,

END_DATETIME,

FORMAT,

MAX_LENGTH,

MAX_NUMBER,

MIN_LENGTH,

MIN_NUMBER,

PHONE_NUMBER_WITH_EXPLICIT_COUNTRY_CODE,

REGEX,

SPECIAL_CHARACTERS,

START_DATE,

START_DATETIME,

URL,

URL_ALLOWED_DOMAINS,

URL_BLOCKED_DOMAINS,

WHITESPACE

shouldApplyNormalization

boolean

Last modified on December 16, 2025

⌘I