Know Your Business

HSN to MCC

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

post/verify/hsn_to_mcc

Request

  • Base URL
    https://prod.idto.ai
  • URL
    https://prod.idto.ai/verify/hsn_to_mcc
  • Auth
    API key in header X-Client-ID and API key in header X-API-KEY

Request body

hsn_codestring required

HSN code for which MCC mapping is required

consentstring required

User consent flag (must be 'Y')

consent_textstring required
user_idstring

Optional user reference identifier

Example request

{
  "hsn_code": "12345678",
  "consent": "Y",
  "consent_text": "We confirm obtaining valid customer consent to access/process their HSN data. Consent remains valid, informed, and unwithdrawn.",
  "user_id": "user_12345"
}

Response

Successful response

statusstring
chargeblestring
user_consentstring

Example response

{
  "status": "success",
  "result": {
    "hsn_code": "12345678",
    "hsn_description": "STRUCTURES (EXCLUDING PREFABRICATED BUILDINGS...)",
    "mcc_code": "1234"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.