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

# GST to MCC

`POST /verify/gst_to_mcc`

Fetches MCC (Merchant Category Code) details mapped to a GST number. This API is billable even when the GST number is invalid.

## Request body

- GSTtoMCCRequest
  - `gst_no` string, required
  - `consent` string, required
  - `consent_text` string, required
  - `user_id` string

## Response `200`

Successful response (including billable non-data cases)

- GSTtoMCCResponse
  - `status` string
  - `result` union
    - GSTtoMCCResult
      - `gst` string
      - `business_details` object[]
        - `gdes` string
        - `hsncd` string
        - `mcc_code` string
        - `saccd` string
        - `sdes` string
    - 'Invalid GST Number'
  - `chargeble` string
  - `user_consent` string

## Other responses

- `400` — Bad request — missing GST number or consent details.
- `401` — Unauthorized — authkey missing or invalid.
- `403` — Forbidden — insufficient privileges or IP not whitelisted.
- `429` — Too many requests — rate 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)