---
title: "Match Engine"
method: POST
path: "/v2/kyc/match"
---

# Match Engine

`POST /v2/kyc/match`

🏏 If strings had a cricket "match", our API would be the third umpire. Always precise, always unbiased!

## Headers

- `client_id` string, required
- `client_secret` string, required

## Request body

- object
  - `reference_id` string, required — Any unique ID assigned by you for this API request.
  - `text1` string, required — The first text/name that needs to be matched.
  - `text2` string, required — The second text/name to be matched
  - `threshold` object, required — The minimum match percentage that is acceptable.
    - `textual` integer — The threshold for the textual matching
    - `phonetic` integer — The threshold for the phonetic match

## Response `200`

200

- object
  - `decentroTxnId` string
  - `status` string
  - `responseCode` string
  - `message` string
  - `data` object
    - `textualMatch` object
      - `matchScore` integer
      - `matchStatus` boolean
    - `phoneticMatch` object
      - `matchScore` integer
      - `matchStatus` boolean
  - `responseKey` string

## Other responses

- `400` — 400

---

[API](https://skmtc.dev/decentro/apis/decentro-staging.md) · [All operations](https://skmtc.dev/decentro/apis/decentro-staging/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decentro/decentro-staging/revisions/f1a86ce4638c/schema)