---
title: "POST /matchingworkflows/{workflowName}/matches"
method: POST
path: "/matchingworkflows/{workflowName}/matches"
---

# POST /matchingworkflows/{workflowName}/matches

`POST /matchingworkflows/{workflowName}/matches`

Returns the corresponding Match ID of a customer record if the record has been processed in a rule-based matching workflow.

You can call this API as a dry run of an incremental load on the rule-based matching workflow.

## Path parameters

- `workflowName` string, required

## Request body

- object
  - `record` object, required — The record to fetch the Match ID for.
  - `applyNormalization` boolean — Normalizes the attributes defined in the schema in the input data. For example, if an attribute has an <code>AttributeType</code> of <code>PHONE_NUMBER</code>, and the data in the input table is in a format of 1234567890, Entity Resolution will normalize this field in the output to (123)-456-7890.

## Response `200`

Success

- GetMatchIdOutput
  - `matchId` string — The unique identifiers for this group of match records.
  - `matchRule` string — The rule the record matched on.

## Other responses

- `480` — ThrottlingException
- `481` — InternalServerException
- `482` — ResourceNotFoundException
- `483` — AccessDeniedException
- `484` — ValidationException

---

[API](https://skmtc.net/aws/apis/entityresolution.md) · [All operations](https://skmtc.net/aws/apis/entityresolution/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/entityresolution/versions/480b85498767/schema)