---
title: "Search contract rules by tag"
method: GET
path: "/search/contract/rules"
tags: ["Search", "Contracts"]
---

# Search contract rules by tag

`GET /search/contract/rules`

## Request

- The document declares no server URL.
- Auth: none declared

Returns all contract rules across all artifacts that contain the specified tag.

## Query parameters

- `tag` string, required

## Response `200`

A list of contract rules matching the specified tag, with their artifact coordinates.

- ContractRuleSearchResult[]
  - `groupId` string: The group ID of the artifact containing the rule.
  - `artifactId` string: The artifact ID containing the rule.
  - `globalId` integer: The global ID of the version (null for artifact-level rules).
  - `ruleCategory` 'DOMAIN' | 'MIGRATION': The rule category (DOMAIN or MIGRATION).
  - `rule` ContractRule: A single contract rule definition.
    - `name` string, required: The rule name.
    - `kind` 'CONDITION' | 'TRANSFORM', required: The rule kind.
    - `type` string, required: Rule executor type (CEL, CEL_FIELD, ENCRYPT, etc.).
    - `mode` 'WRITE' | 'READ' | 'WRITEREAD' | 'UPGRADE' | 'DOWNGRADE', required: When the rule is applied.
    - `expr` string: The rule expression.
    - `params` object: Rule parameters.
    - `tags` string[]: Tags for categorizing the rule.
    - `onSuccess` 'NONE' | 'ERROR' | 'DLQ': Action on rule success.
    - `onFailure` 'NONE' | 'ERROR' | 'DLQ': Action on rule failure.
    - `disabled` boolean: Whether the rule is disabled.

## Other responses

- `400`: Common response for all operations that can return a `400` error.
- `500`: Common response for all operations that can fail with an unexpected server error.

## Changes

- **2026-10-31** `ff9684af2aad`: 10 info
  - added the optional property `ruleViolation/causes/items/code` to the response with the `400` status
  - added the optional property `ruleViolation/causes/items/code` to the response with the `500` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `400` status
  - added the optional property `ruleViolation/causes/items/direction` to the response with the `500` status
  - …6 more
- **2026-10-29** `f17f5df4e79c`: 2 info
  - added the optional property `ruleViolation` to the response with the `400` status
  - added the optional property `ruleViolation` to the response with the `500` status
- **2026-04-16** `9547b63c5be8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/changes/search/contract/rules/get.md)

---

[API](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3.md) - [All operations](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/apicurio/apis/apicurio-registry-api-v3/revisions/ff9684af2aad?raw)