--- title: "Changes to Query by example matcher" method: POST path: "/match/{dataset}" --- # Changes to Query by example matcher `POST /match/{dataset}` > Every recorded change to this operation, newest first. ## Timeline Changed in 10 of 28 revisions. - **2026-06-13** `c5a282ece45d`: 1 warning, 6 info - **2026-04-21** `024572c7ad35`: 4 breaking, 8 info - **2025-06-15** `bde582a678cc`: 2 info - **2025-03-08** `918214e0f3be`: 1 info - **2024-12-08** `ba18f11366fb`: 3 breaking, 3 info - **2023-10-26** `968352e22dd9`: 10 breaking, 10 info - **2022-10-04** `c17b65cd8059`: 1 breaking, 6 info - **2022-05-27** `4b38679f47dc`: 1 warning - **2022-05-04** `aafc936b438d`: 1 breaking, 2 info - **2022-04-09** `e3a7d874b6d7`: 4 breaking, 2 warning, 7 info ## Changes - **2026-06-13** `c5a282ece45d`: 1 warning, 6 info - removed the optional property `responses/additionalProperties/results/items/token` from the response with the `200` status - removed `subschema #1, subschema #2` from the `responses/additionalProperties/results/items/first_seen` response property `anyOf` list for the response status `200` - removed `subschema #1, subschema #2` from the `responses/additionalProperties/results/items/last_change` response property `anyOf` list for the response status `200` - removed `subschema #1, subschema #2` from the `responses/additionalProperties/results/items/last_seen` response property `anyOf` list for the response status `200` - removed `subschema #1, subschema #2` from the `responses/additionalProperties/results/items/properties/additionalProperties/items/anyOf[subschema #2: EntityResponse]/first_seen` response property `anyOf` list for the response status `200` - removed `subschema #1, subschema #2` from the `responses/additionalProperties/results/items/properties/additionalProperties/items/anyOf[subschema #2: EntityResponse]/last_change` response property `anyOf` list for the response status `200` - removed `subschema #1, subschema #2` from the `responses/additionalProperties/results/items/properties/additionalProperties/items/anyOf[subschema #2: EntityResponse]/last_seen` response property `anyOf` list for the response status `200` - **2026-04-21** `024572c7ad35`: 4 breaking, 8 info - for the `query` request parameter `algorithm`, default value was changed from `logic-v1` to `best` - for the `query` request parameter `cutoff`, default value was changed from `0.5` to `0.7` - removed the required property `matcher` from the response with the `200` status - removed the required property `responses/additionalProperties/results/items/features` from the response with the `200` status - added the new optional `query` request parameter `exclude_entity_ids` - added the new optional request property `config` - `query` request parameter `cutoff` was deprecated - added the optional property `detail/items/ctx` to the response with the `422` status - added the optional property `detail/items/input` to the response with the `422` status - the response property `responses/additionalProperties/results/items/match` became required for the status `200` - the `match` response's property default value `false` was removed for the status `200` - added the required property `responses/additionalProperties/results/items/explanations` to the response with the `200` status - **2025-06-15** `bde582a678cc`: 2 info - deleted the `query` request parameter `fuzzy` with deprecation - added the optional property `responses/additionalProperties/results/items/token` to the response with the `200` status - **2025-03-08** `918214e0f3be`: 1 info - `query` request parameter `fuzzy` was deprecated - **2024-12-08** `ba18f11366fb`: 3 breaking, 3 info - for the `query` request parameter `algorithm`, default value was changed from `regression-v1` to `logic-v1` - the `queries/additionalProperties/properties/additionalProperties/anyOf[subschema #2]/items/` request property type changed from `string` to no type - the `responses/additionalProperties/query/properties/additionalProperties/anyOf[subschema #2]/items/` response's property type changed from `string` to no type for status `200` - added the new optional `query` request parameter `include_dataset` - added the new optional `query` request parameter `topics` - for the `query` request parameter `limit`, the max was increased from `10.00` to `500.00` - **2023-10-26** `968352e22dd9`: 10 breaking, 10 info - for the `query` request parameter `cutoff`, default value was changed from `0.1` to `0.5` - the response property `responses/additionalProperties/results/items/first_seen` became optional for the status `200` - the response property `responses/additionalProperties/results/items/last_seen` became optional for the status `200` - the response property `responses/additionalProperties/results/items/properties/additionalProperties/items/anyOf[subschema #2: EntityResponse]/first_seen` became optional for the status `200` - the response property `responses/additionalProperties/results/items/properties/additionalProperties/items/anyOf[subschema #2: EntityResponse]/last_seen` became optional for the status `200` - response property `matcher/additionalProperties/description` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `responses/additionalProperties/results/items/first_seen` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `responses/additionalProperties/results/items/last_seen` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `responses/additionalProperties/results/items/properties/additionalProperties/items/anyOf[subschema #2: EntityResponse]/first_seen` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - response property `responses/additionalProperties/results/items/properties/additionalProperties/items/anyOf[subschema #2: EntityResponse]/last_seen` list-of-types was widened by adding types `null` to media type `application/json` of response `200` - added the new optional `query` request parameter `algorithm` - added the new optional `query` request parameter `changed_since` - added the new optional `query` request parameter `exclude_dataset` - added the new optional `query` request parameter `exclude_schema` - added the new optional `query` request parameter `fuzzy` - added the new optional request property `queries/additionalProperties/id` - added the new optional request property `weights` - added the optional property `responses/additionalProperties/query/id` to the response with the `200` status - added the optional property `responses/additionalProperties/results/items/last_change` to the response with the `200` status - added the optional property `responses/additionalProperties/results/items/properties/additionalProperties/items/anyOf[subschema #2: EntityResponse]/last_change` to the response with the `200` status - **2022-10-04** `c17b65cd8059`: 1 breaking, 6 info - the `responses/additionalProperties/` response's property type changed from no type to `object` for status `200` - added the non-success response with the status `500` - added the optional property `responses/additionalProperties/status` to the response with the `200` status - removed `#/components/schemas/EntityMatches, #/components/schemas/PartialErrorResponse` from the `responses/additionalProperties/` response property `anyOf` list for the response status `200` - added the required property `responses/additionalProperties/query` to the response with the `200` status - added the required property `responses/additionalProperties/results` to the response with the `200` status - added the required property `responses/additionalProperties/total` to the response with the `200` status - **2022-05-27** `4b38679f47dc`: 1 warning - for the `query` request parameter `limit`, the max was set to `10.00` - **2022-05-04** `aafc936b438d`: 1 breaking, 2 info - response property `detail/items/loc/items/` list-of-types was widened by adding types `integer` to media type `application/json` of response `422` - added the optional property `responses/additionalProperties/anyOf[subschema #1: EntityMatches]/results/items/properties/additionalProperties/items/anyOf[subschema #2: EntityResponse]/target` to the response with the `200` status - added the optional property `responses/additionalProperties/anyOf[subschema #1: EntityMatches]/results/items/target` to the response with the `200` status - **2022-04-09** `e3a7d874b6d7`: 4 breaking, 2 warning, 7 info - for the `query` request parameter `limit`, the exclusiveMaximum was decreased from `1000.00` to `10.00` - the `responses/additionalProperties/` response's property type changed from `object` to no type for status `200` - removed the required property `responses/additionalProperties/query` from the response with the `200` status - removed the required property `responses/additionalProperties/results` from the response with the `200` status - deleted the `query` request parameter `fuzzy` - deleted the `query` request parameter `nested` - added the new optional `query` request parameter `cutoff` - added the new optional `query` request parameter `threshold` - request property `queries/additionalProperties/properties/additionalProperties/` list-of-types was widened by adding types `string` to media type `application/json` - added the non-success response with the status `400` - added `#/components/schemas/EntityMatches, #/components/schemas/PartialErrorResponse` to the `responses/additionalProperties/` response property `anyOf` list for the response status `200` - added the required property `limit` to the response with the `200` status - added the required property `matcher` to the response with the `200` status --- [Operation](https://skmtc.dev/opensanctions/apis/opensanctions-api/docs/match/:dataset/post.md) - [API](https://skmtc.dev/opensanctions/apis/opensanctions-api.md) - [Page](https://skmtc.dev/opensanctions/apis/opensanctions-api/changes/match/:dataset/post)