--- updatedAt: 2026-08-25T17:49:49.000Z agentTools: projectIndex: https://docs.gtm.ai/llms.txt --- # List Score Configs Returns a paginated list of attribute-score model configurations. Each item carries the full config definition — `name`, `status`, `modelType`, the ordered `elements` (with their `rules` and `criteria`), and the derived `fieldsUsedInRules` — plus `createdAt` and `updatedAt` under `meta`. Filter by `filter[name]` (case-insensitive contains match on `name`). Order with `sort` — allowed fields: `name`, `createdAt`, `updatedAt`. Prefix the field with `-` for descending order. Use `page[number]` (1-based) and `page[size]` (default `25`, max `200`) to paginate. Returns `200` with a paginated array of score config resources and JSON:API pagination links. Returns `400` if filter, sort, or pagination parameters are invalid. # OpenAPI definition ```json { "openapi": "3.0.0", "info": { "title": "Data Quality API V1", "version": "1.0", "contact": { "name": "ZoomInfo Customer Support", "email": "help@zoominfo.com" }, "description": "API for interacting with ZoomInfo data quality services." }, "tags": [ { "name": "Score" } ], "paths": { "/data-quality/v1/score/configs": { "get": { "operationId": "Score_listScoreConfigs", "summary": "List Score Configs", "description": "Returns a paginated list of attribute-score model configurations.\n\nEach item carries the full config definition — `name`, `status`,\n`modelType`, the ordered `elements` (with their `rules` and `criteria`), and\nthe derived `fieldsUsedInRules` — plus `createdAt` and `updatedAt` under\n`meta`.\n\nFilter by `filter[name]` (case-insensitive contains match on `name`).\nOrder with `sort` — allowed fields: `name`, `createdAt`, `updatedAt`.\nPrefix the field with `-` for descending order. Use `page[number]`\n(1-based) and `page[size]` (default `25`, max `200`) to paginate.\n\nReturns `200` with a paginated array of score config resources and JSON:API\npagination links. Returns `400` if filter, sort, or pagination parameters\nare invalid.", "parameters": [ { "name": "filter[name]", "in": "query", "required": false, "description": "Case-insensitive contains match on the score config `name`.", "schema": { "type": "string" }, "explode": false }, { "name": "page[number]", "in": "query", "required": false, "description": "Page number for the results. Defaults to `1`.", "schema": { "type": "integer", "format": "int32", "minimum": 1, "default": 1 }, "explode": false }, { "name": "page[size]", "in": "query", "required": false, "description": "Number of records to return per page. Default `25`, maximum `200`.", "schema": { "type": "integer", "format": "int32", "minimum": 1, "maximum": 200, "default": 25 }, "explode": false }, { "name": "sort", "in": "query", "required": false, "description": "Field to sort by. Prefix with `-` for descending order. Allowed values:\n`name`, `createdAt`, `updatedAt`.", "schema": { "type": "string" }, "explode": false } ], "responses": { "200": { "description": "Success", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ScoreConfigListJsonApiModel" } } } }, "400": { "description": "Bad Request", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } }, "401": { "description": "Unauthorized", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } }, "403": { "description": "Forbidden", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } }, "429": { "description": "Too Many Requests", "content": { "application/vnd.api+json": { "schema": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorResponseModel" } } } } }, "tags": [ "Score" ], "security": [ { "OAuth2Auth": [ "api:data-quality:read" ] } ], "x-api-roles": [ "fea:zia" ] } } }, "security": [ { "OAuth2Auth": [] } ], "components": { "schemas": { "ZoomInfo.Core.Foundations.ErrorSourceModel": { "type": "object", "properties": { "cookie": { "type": "string", "description": "Identifies the cookie name that caused the issue" }, "header": { "type": "string", "description": "Identifies the header name that caused the error" }, "pointer": { "type": "string", "description": "An RFC 6901 compliant JSON pointer to the entity in the request body that caused the error" }, "parameter": { "type": "string", "description": "The name of the path or query parameter that caused the error" } } }, "ZoomInfo.Core.Foundations.ErrorModel": { "type": "object", "required": [ "id", "code", "status" ], "properties": { "id": { "type": "string", "description": "The unique id used to identify this specific error instance" }, "code": { "type": "string", "description": "The error code describing the error category. A full list of error codes can be found in the documentation for each service" }, "detail": { "type": "string", "description": "Message containing the specific details about this occurrence of the error" }, "source": { "allOf": [ { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorSourceModel" } ], "description": "An optional object identifying which part of the request caused the error" }, "status": { "type": "string", "description": "The HTTP status code for the error" }, "title": { "type": "string", "description": "The error name that describes this type of error" } }, "description": "The object describing a specific error from the API" }, "ZoomInfo.Core.Foundations.ErrorResponseModel": { "type": "object", "required": [ "errors" ], "properties": { "detail": { "type": "string", "description": "A high-level detail of the error(s) that occurred during the request" }, "title": { "type": "string", "description": "A high-level summary of the error(s) detected" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/ZoomInfo.Core.Foundations.ErrorModel" }, "description": "The list of errors raised during the request" } }, "description": "The standard error response body model for the ZoomInfo API." }, "ScoreConfigStatus": { "type": "string", "enum": [ "ACTIVE", "ARCHIVED" ], "description": "Lifecycle status of a score configuration.", "x-enumDescriptions": { "ACTIVE": "The score config is active and available for scoring.", "ARCHIVED": "The score config has been archived (soft-deleted) and is no longer used for scoring." } }, "ScoreModelType": { "type": "string", "enum": [ "ATTRIBUTE" ], "description": "Type of scoring model.", "x-enumDescriptions": { "ATTRIBUTE": "Weighted attribute-scoring model: a weighted sum of per-field rule matches." } }, "ScoreCriterionOperator": { "type": "string", "enum": [ "TEXT_EQUALS", "TEXT_NOT_EQUALS", "TEXT_CONTAINS", "TEXT_NOT_CONTAINS", "TEXT_STARTS", "TEXT_NOT_STARTS", "TEXT_ENDS", "TEXT_NOT_ENDS", "NUM_EQUALS", "NUM_MORE", "NUM_LESS", "NUM_BETWEEN", "BOOL_TRUE", "BOOL_FALSE", "IS_NULL", "IS_NOT_NULL", "DATE_EXACT", "DATE_AFTER", "DATE_BEFORE", "PICKLIST_EQUALS", "PICKLIST_NOT_EQUALS", "MULTIPICKLIST_EQUALS", "MULTIPICKLIST_NOT_EQUALS", "MULTIPICKLIST_HAS", "MULTIPICKLIST_HAS_NONE", "MULTIPICKLIST_HAS_ALL", "DIVIDER" ], "description": "Comparison operator for a score rule criterion.", "x-enumDescriptions": { "TEXT_EQUALS": "Field value equals the comparison value.", "TEXT_NOT_EQUALS": "Field value does not equal the comparison value.", "TEXT_CONTAINS": "Field value contains the comparison value as a substring.", "TEXT_NOT_CONTAINS": "Field value does not contain the comparison value as a substring.", "TEXT_STARTS": "Field value starts with the comparison value.", "TEXT_NOT_STARTS": "Field value does not start with the comparison value.", "TEXT_ENDS": "Field value ends with the comparison value.", "TEXT_NOT_ENDS": "Field value does not end with the comparison value.", "NUM_EQUALS": "Numeric field equals the comparison value.", "NUM_MORE": "Numeric field is greater than the comparison value.", "NUM_LESS": "Numeric field is less than the comparison value.", "NUM_BETWEEN": "Numeric field falls between the two comparison values.", "BOOL_TRUE": "Boolean field is true.", "BOOL_FALSE": "Boolean field is false.", "IS_NULL": "Field has no value.", "IS_NOT_NULL": "Field has a value.", "DATE_EXACT": "Date field equals the comparison date.", "DATE_AFTER": "Date field is after the comparison date.", "DATE_BEFORE": "Date field is before the comparison date.", "PICKLIST_EQUALS": "Single-select picklist value is the comparison value.", "PICKLIST_NOT_EQUALS": "Single-select picklist value is not the comparison value.", "MULTIPICKLIST_EQUALS": "Multi-select picklist exactly equals the comparison values.", "MULTIPICKLIST_NOT_EQUALS": "Multi-select picklist does not equal the comparison values.", "MULTIPICKLIST_HAS": "Multi-select picklist contains at least one comparison value.", "MULTIPICKLIST_HAS_NONE": "Multi-select picklist contains none of the comparison values.", "MULTIPICKLIST_HAS_ALL": "Multi-select picklist contains all of the comparison values.", "DIVIDER": "Starts an OR alternative in a rule; [A, B, DIVIDER, C] means (A AND B) OR C." } }, "ScoreCriterion": { "type": "object", "required": [ "operator" ], "properties": { "operator": { "allOf": [ { "$ref": "#/components/schemas/ScoreCriterionOperator" } ], "description": "Comparison operator. `DIVIDER` marks an OR boundary in a rule and carries no values." }, "values": { "type": "array", "items": { "type": "string" }, "maxItems": 100, "description": "Operand values for the operator. Omitted for nullary operators (boolean and\nnull checks) and for `DIVIDER`; a single entry for most text, number, and\ndate operators; exactly two for `NUM_BETWEEN`." } }, "description": "A single comparison criterion within a score rule." }, "ScoreRule": { "type": "object", "required": [ "name", "score", "criteria" ], "properties": { "name": { "type": "string", "description": "Display name for the rule." }, "score": { "type": "number", "format": "double", "description": "Score contributed by this rule when its criteria match." }, "criteria": { "type": "array", "items": { "$ref": "#/components/schemas/ScoreCriterion" }, "description": "Ordered criteria evaluated for this rule. At least one is required." } }, "description": "A scoring rule: criteria that, when matched, contribute `score` to the owning element." }, "ScoreElement": { "type": "object", "required": [ "field", "weight", "rules" ], "properties": { "field": { "type": "string", "description": "Name of the input field this element scores." }, "weight": { "type": "number", "format": "double", "minimum": 0, "maximum": 100, "description": "Relative weight of this element in the weighted sum. Between `0` and `100`." }, "rules": { "type": "array", "items": { "$ref": "#/components/schemas/ScoreRule" }, "description": "Ordered rules evaluated for this element." } }, "description": "A weighted scoring element bound to a single input field." }, "ScoreConfigAttributes": { "type": "object", "required": [ "name", "status", "modelType", "elements", "fieldsUsedInRules" ], "properties": { "name": { "type": "string", "description": "Display name for the score config." }, "status": { "allOf": [ { "$ref": "#/components/schemas/ScoreConfigStatus" } ], "description": "Lifecycle status of the score config.", "readOnly": true }, "modelType": { "allOf": [ { "$ref": "#/components/schemas/ScoreModelType" } ], "description": "Type of scoring model. Only `ATTRIBUTE` is currently supported.", "readOnly": true }, "elements": { "type": "array", "items": { "$ref": "#/components/schemas/ScoreElement" }, "description": "Ordered scoring elements that define how records are scored." }, "fieldsUsedInRules": { "type": "array", "items": { "type": "string" }, "description": "Distinct input field names referenced by this config's elements, sorted\nalphabetically. Read-only; derived from `elements[].field`.", "readOnly": true } }, "description": "Attributes of a score configuration." }, "ScoreConfigMeta": { "type": "object", "required": [ "createdAt", "updatedAt" ], "properties": { "createdAt": { "type": "string", "format": "date-time", "description": "ISO 8601 timestamp at which this score config was created.", "readOnly": true }, "updatedAt": { "type": "string", "format": "date-time", "description": "ISO 8601 timestamp at which this score config was last updated.", "readOnly": true } }, "description": "Non-standard metadata for a score config." }, "ScoreConfig": { "type": "object", "required": [ "id", "type", "attributes" ], "properties": { "id": { "type": "string", "description": "The unique identifier for the resource" }, "type": { "type": "string", "description": "The type of the resource", "default": "ScoreConfig", "pattern": "ScoreConfig" }, "attributes": { "allOf": [ { "$ref": "#/components/schemas/ScoreConfigAttributes" } ], "description": "The attributes defining the resource" }, "meta": { "allOf": [ { "$ref": "#/components/schemas/ScoreConfigMeta" } ], "description": "Non-standard meta information about the resource", "readOnly": true } }, "description": "A score configuration resource (identity, model type, and scoring elements)." }, "ScoreConfigPageMeta": { "type": "object", "required": [ "number", "size", "totalPages", "totalItems" ], "properties": { "number": { "type": "integer", "format": "uint32", "description": "Current page number (1-based).", "readOnly": true }, "size": { "type": "integer", "format": "uint32", "description": "Number of items in the current page.", "readOnly": true }, "totalPages": { "type": "integer", "format": "uint32", "description": "Total number of pages available.", "readOnly": true }, "totalItems": { "type": "integer", "format": "uint32", "description": "Total number of items across all pages.", "readOnly": true } }, "description": "Per-page metadata for paginated score config list responses." }, "ScoreConfigListMeta": { "type": "object", "required": [ "page" ], "properties": { "page": { "allOf": [ { "$ref": "#/components/schemas/ScoreConfigPageMeta" } ], "description": "Current page details and totals.", "readOnly": true } }, "description": "Page meta-data for paginated score config list responses." }, "ScoreConfigListLinks": { "type": "object", "properties": { "self": { "type": "string", "format": "uri", "description": "The link that generated the current response document" }, "first": { "type": "string", "format": "uri", "description": "A link to the first page of data" }, "last": { "type": "string", "format": "uri", "description": "A link to the last page of data" }, "prev": { "type": "string", "format": "uri", "description": "A link to the previous page of data" }, "next": { "type": "string", "format": "uri", "description": "A link to the next page of data" } }, "description": "Paging links for score config list responses." }, "ScoreConfigListJsonApiModel": { "type": "object", "required": [ "data" ], "properties": { "data": { "type": "array", "items": { "$ref": "#/components/schemas/ScoreConfig" }, "description": "The primary data of the document" }, "meta": { "allOf": [ { "$ref": "#/components/schemas/ScoreConfigListMeta" } ], "description": "Non-standard meta information about the document" }, "links": { "allOf": [ { "$ref": "#/components/schemas/ScoreConfigListLinks" } ], "description": "Links related to the primary data" } }, "description": "JSON API model for a paginated list of score configs." } }, "securitySchemes": { "OAuth2Auth": { "type": "oauth2", "flows": { "authorizationCode": { "authorizationUrl": "https://login.zoominfo.com", "tokenUrl": "https://okta-login.zoominfo.com/oauth2/default/v1/token", "scopes": { "api:data-quality:execute": "Execute Data Quality operations, including the prepare pipeline (parse/validate/normalize plus opt-in enrichments and custom normalization) and synchronous scoring and segmentation", "api:data-quality:read": "Read Data Quality configurations, including score and segmentation configs", "api:data-quality:manage": "Create, update, and delete Data Quality configurations, including score and segmentation configs" } } } } } }, "servers": [ { "url": "https://api.zoominfo.com/gtm", "description": "Base URL for the Data Quality API" } ], "x-beta": true } ``` # Sibling pages * [Create Score Config](https://docs.gtm.ai/zoominfoenterprise/reference/score_createscoreconfig.md) * [Get Score Config](https://docs.gtm.ai/zoominfoenterprise/reference/score_getscoreconfig.md) * [Update Score Config](https://docs.gtm.ai/zoominfoenterprise/reference/score_updatescoreconfig.md) * [Delete Score Config](https://docs.gtm.ai/zoominfoenterprise/reference/score_deletescoreconfig.md) * [Run Scoring](https://docs.gtm.ai/zoominfoenterprise/reference/score_runscore.md)