---
title: "List Score Configs"
method: GET
path: "/data-quality/v1/score/configs"
tags: ["Score"]
---

# List Score Configs

`GET /data-quality/v1/score/configs`

## Request

- Base URL: `https://api.zoominfo.com/gtm`
- URL: `https://api.zoominfo.com/gtm/data-quality/v1/score/configs`
- Auth: OAuth 2
  - Authorization code: `https://login.zoominfo.com`
  - Token URL: `https://okta-login.zoominfo.com/oauth2/default/v1/token` scopes: `api:data-quality:read`

Returns a paginated list of attribute-score model configurations.

This is how you discover a `configId` before passing it to Run Scoring, and how you check
which models already exist before creating a duplicate.

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.

This endpoint does not consume credits.

## Query parameters

- `filter[name]` string
- `page[number]` integer
- `page[size]` integer
- `sort` string

## Response `200`

Success

- ScoreConfigListJsonApiModel: JSON API model for a paginated list of score configs.
  - `data` ScoreConfig[], required: The primary data of the document
    - `id` string, required: The unique identifier for the resource
    - `type` string, required: The type of the resource
    - `attributes` ScoreConfigAttributes, required: Attributes of a score configuration.
      - `name` string, required: Display name for the score config.
      - `status` 'ACTIVE' | 'ARCHIVED', required: Lifecycle status of a score configuration.
      - `modelType` 'ATTRIBUTE', required: Type of scoring model.
      - `elements` ScoreElement[], required: Ordered scoring elements that define how records are scored.
        - `field` string, required: Name of the input field this element scores.
        - `weight` number, double, required: Relative weight of this element in the weighted sum. Between `0` and `100`.
        - `rules` ScoreRule[], required: Ordered rules evaluated for this element.
          - `name` string, required: Display name for the rule.
          - `score` number, double, required: Score contributed by this rule when its criteria match.
          - `criteria` ScoreCriterion[], required: Ordered criteria evaluated for this rule. At least one is required.
            - `operator` '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', required: Comparison operator for a score rule criterion.
            - `values` string[]: Operand values for the operator. Omitted for nullary operators (boolean and null checks) and for `DIVIDER`; a single entry for most text, number, and date operators; exactly two for `NUM_BETWEEN`.
      - `fieldsUsedInRules` string[], required: Distinct input field names referenced by this config's elements, sorted alphabetically. Read-only; derived from `elements[].field`.
    - `meta` ScoreConfigMeta: Non-standard metadata for a score config.
      - `createdAt` string, date-time, required: ISO 8601 timestamp at which this score config was created.
      - `updatedAt` string, date-time, required: ISO 8601 timestamp at which this score config was last updated.
  - `meta` ScoreConfigListMeta: Page meta-data for paginated score config list responses.
    - `page` ScoreConfigPageMeta, required: Per-page metadata for paginated score config list responses.
      - `number` integer, required: Current page number (1-based).
      - `size` integer, required: Number of items in the current page.
      - `totalPages` integer, required: Total number of pages available.
      - `totalItems` integer, required: Total number of items across all pages.
  - `links` ScoreConfigListLinks: Paging links for score config list responses.
    - `self` string, uri: The link that generated the current response document
    - `first` string, uri: A link to the first page of data
    - `last` string, uri: A link to the last page of data
    - `prev` string, uri: A link to the previous page of data
    - `next` string, uri: A link to the next page of data

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `429`: Too Many Requests

---

[API](https://skmtc.dev/zoominfo/apis/data-quality-api-v1.md) - [All operations](https://skmtc.dev/zoominfo/apis/data-quality-api-v1/llms.txt) - [OpenAPI document](https://skmtc.dev/zoominfo/apis/data-quality-api-v1/revisions/7229ed1f3b09?raw)