Zoho: Scoring Rules — scoring Rules get Scoring Rules

← Scoring rules operations · Get started

Operation zoho.getscoringrules

Provider route: GET /crm/v8/settings/automation/scoring_rules. Alter supplies the connection’s credentials and routing.

Call through Alter

Install @alter-ai/sdk @alter-ai/zoho with npm, or alter-sdk-zoho with pip. Supply your connected customer’s grant ID and the arguments described below.

import { App } from "@alter-ai/sdk";
import { ZohoIntegration } from "@alter-ai/zoho";

async function execute(input: Parameters<ZohoIntegration["scoringRules"]["getScoringRules"]>[0]) {
  const app = new App({ apiKey: process.env.ALTER_API_KEY! });
  try {
    const provider = new ZohoIntegration(app, { grantId: process.env.PROVIDER_GRANT_ID! });
    const call = await provider.scoringRules.getScoringRules(input);
    const result = await call.wait();
    return result.bodyJson();
  } finally {
    await app.close();
  }
}

import os
from alter_sdk import App
from alter_sdk_zoho import ZohoIntegration

async def execute(arguments):
    async with App(api_key=os.environ["ALTER_API_KEY"]) as app:
        provider = ZohoIntegration(app, {"grant_id": os.environ["PROVIDER_GRANT_ID"]})
        call = await provider.scoring_rules.get_scoring_rules(arguments)
        result = await call.wait()
        return result.body_json()

Input

Field	Type	Presence	Description and constraints
$	object	Root	Additional keys: not allowed
query	object	Optional	Additional keys: not allowed
query.module	string	Optional	Maximum length: 100
query.layout_id	number	Optional
query.page	integer	Optional	Format: int32
query.per_page	integer	Optional	Format: int32
query.name	string	Optional	Maximum length: 25
query.fields	string	Optional	Maximum length: 255
query.active	boolean	Optional

Response

Response media type: application/json. The table describes the pinned successful response. Referenced models link to their complete fields.

Field	Type	Presence	Description and constraints
$	JSON	Root
$ (anyOf 1)	Model	Alternative	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules
$ (anyOf 2)	null	Alternative

Referenced models: Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules

Schemas

24 more schemas are linked from the tables above, on the schema pages.

Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules

Field	Type	Presence	Description and constraints
$	object	Root	Represents the response body for the list Scoring Rules operation. Additional keys: not allowed
info	Model	Optional	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules info
scoring_rules	array	Optional	Represents an array of Scoring Rule summary objects returned in the list response. Maximum items: 300
scoring_rules[]	Model	Each item	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item

Referenced models: Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item, Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules info

Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item

Field	Type	Presence	Description and constraints
$	object	Root	Represents the root element for defining a scoring rule, including layout, fields, custom fields, and scoring configurations. Additional keys: not allowed
active	boolean	Optional	Indicates whether the Scoring Rule is active (`true`) or inactive (`false`).
created_by	Model	Optional	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item created by
created_time	string	Optional	Scoring rule created time Maximum length: 255
custom_fields	JSON	Optional
custom_fields (anyOf 1)	array	Alternative	Represents the custom fields configured for this Scoring Rule to hold referenced scores. Maximum items: 6
custom_fields (anyOf 1)[]	Model	Each item	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item custom fields null item
custom_fields (anyOf 2)	null	Alternative	Represents the custom fields configured for this Scoring Rule to hold referenced scores. Maximum items: 6
custom_fields (anyOf 2)[]	Model	Each item	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item custom fields null item
description	JSON	Optional
description (anyOf 1)	string	Alternative	Represents the optional description of the Scoring Rule. This field is nullable. Maximum length: 500
description (anyOf 2)	null	Alternative	Represents the optional description of the Scoring Rule. This field is nullable. Maximum length: 500
field_rules	array	Optional	Module field based score configuration can be added here Maximum items: 50
field_rules[]	Model	Each item	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item field rules item
has_signal_rules	boolean	Optional	It defines whether the production scoring rule has any signal rules or not. Applicable only for Leads and Contacts modules rules in Sandbox environment.
id	string	Optional	Represents the unique ID of the Scoring Rule. Maximum length: 255
layout	Model	Optional	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item layout Layout info. If the rule should be created for all layouts, this field can be skipped or set value as null.
modified_by	Model	Optional	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item modified by Scoring rule modified by
modified_time	JSON	Optional
modified_time (anyOf 1)	string	Alternative	Represents the date and time when the Scoring Rule was last modified, in ISO 8601 format. This field is nullable. Maximum length: 255
modified_time (anyOf 2)	null	Alternative	Represents the date and time when the Scoring Rule was last modified, in ISO 8601 format. This field is nullable. Maximum length: 255
module	Model	Required within parent	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item module module info (Required)
name	string	Required within parent	Represents the unique name of the Scoring Rule. Maximum length: 25
signal_rules	JSON	Optional
signal_rules (anyOf 1)	array	Alternative	Touch points based score configurations; applicable only for Leads and Contacts modules Maximum items: 250
signal_rules (anyOf 1)[]	Model	Each item	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item signal rules null item
signal_rules (anyOf 2)	null	Alternative	Touch points based score configurations; applicable only for Leads and Contacts modules Maximum items: 250
signal_rules (anyOf 2)[]	Model	Each item	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item signal rules null item

Referenced models: Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item created by, Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item custom fields null item, Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item field rules item, Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item layout, Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item modified by, Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item module, Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item signal rules null item

Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules info

Field	Type	Presence	Description and constraints
$	object	Root	Nested schema for info Additional keys: not allowed
count	JSON	Optional
count (anyOf 1)	integer	Alternative	Total number of scoring rules returned in the current response page. Format: int32
count (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
more_records	boolean	Optional	Indicates whether additional scoring rules are available beyond the current page.
page	JSON	Optional
page (anyOf 1)	integer	Alternative	Current page number in the paginated response. Format: int32
page (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$
per_page	JSON	Optional
per_page (anyOf 1)	integer	Alternative	no of rules need to be fetched per_page Format: int32
per_page (anyOf 2)	string	Alternative	Pattern: ^-?[0-9]+(?:\.[0-9]+)?(?:[eE][+-]?[0-9]+)?$

Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item created by

Field	Type	Presence	Description and constraints
$	object	Root	Nested schema for created_by Additional keys: not allowed
id	string	Optional	Unique numeric ID of the user who created the scoring rule. Maximum length: 25
name	string	Optional	Full name of the user who created the scoring rule. Maximum length: 255
zuid	string	Optional	Zoho unique ID (ZUID) of the user who created the scoring rule. Maximum length: 255

Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item custom fields null item

Field	Type	Presence	Description and constraints
$	object	Root	Represents the configuration for a custom field associated with a Scoring Rule, including the referenced score field. Additional keys: not allowed
api_name	string	Optional	Represents the API name of the custom field associated with the Scoring Rule. Maximum length: 100
field_label	string	Optional	Represents the display name of the custom field. Required when creating a Scoring Rule. Maximum length: 100
id	string	Optional	Represents the unique ID of the custom field associated with the Scoring Rule. Maximum length: 25
reference_field	Model	Optional	Expand Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item custom fields null item reference field It will hold the referenced score field info. (Required for POST)

Referenced models: Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item custom fields null item reference field

Scoring Rules — scoring Rules get Scoring Rules — response body — info, scoring rules scoring rules item module

Field	Type	Presence	Description and constraints
$	object	Root	Represents the module associated with a Scoring Rule, including the module API name and unique ID. Additional keys: not allowed
api_name	string	Optional	Represents the API name of the module associated with the Scoring Rule. Maximum length: 255
id	string	Optional	Represents the unique ID of the module associated with the Scoring Rule. Maximum length: 25

Policy, approvals and errors

SDK function policy ID: zoho.getscoringrules. Catalog operation: getScoringRules. Rules can name either ID; function rules distinguish managed calls and conservatively cover raw calls sharing the route. Existing grant permissions and policy rules apply. wait() returns an immediate result or waits for a required approval; it never approves the request itself. Persist the approval ID to resume after a restart.

Provider errors retain their response; JSON decoding raises ProviderAPIError for provider failures. ManagedOperationError identifies contract/input/retention errors. See error handling and provider-specific behavior. Sensitive input may be refused before approval storage. A decoding error never resubmits a write.

No-content response statuses: [204]

Official provider source