---
title: "HSN to MCC"
method: POST
path: "/verify/hsn_to_mcc"
tags: ["Know Your Business"]
---

# HSN to MCC

`POST /verify/hsn_to_mcc`

Fetches MCC (Merchant Category Code) details mapped to an HSN code. Requires valid user consent.

## Request body

- HSNtoMCCRequest
  - `hsn_code` string, required — HSN code for which MCC mapping is required
  - `consent` string, required — User consent flag (must be 'Y')
  - `consent_text` string, required
  - `user_id` string — Optional user reference identifier

## Response `200`

Successful response

- HSNtoMCCResponse
  - `status` string
  - `result` HSNtoMCCResult
    - `hsn_code` string
    - `hsn_description` string
    - `mcc_code` string
  - `chargeble` string
  - `user_consent` string

## Other responses

- `400` — Bad request — missing or invalid HSN code or consent details.
- `401` — Unauthorized — authkey missing or invalid.
- `403` — Forbidden — insufficient privileges or IP not whitelisted.
- `429` — Too many requests — request limit exceeded.
- `500` — Internal server error.
- `502` — Bad gateway — vendor error or source down.
- `504` — Gateway timeout — vendor did not respond.

---

[API](https://skmtc.dev/idto/apis/verification-api.md) · [All operations](https://skmtc.dev/idto/apis/verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idto/verification-api/revisions/e3d57dab8db4/schema)