MCC Finder

Specifies a tool designed to extract the Merchant Category Code(MCC) from a given website. -> MCC Finder.

mcc_finder

POST https://secctrl.tutelar.io/api/v1/services/business_profile/mcc_finder

Post parameters description is given below,

Post Parameter	Type	Is Mandatory	Description
website_url	String	Yes	Website Url

Sample Post Parameters

{
    "website_url": "https://apple.com"
}

200: Success Response

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "status": "completed",
    "reference_id": "05f36efb-789e-41ff-b51f-1e6e42a21db9",
    "result": {
        "title": "Apple",
        "description": "Apple is a multinational technology company that designs, manufactures, and sells consumer electronics, computer software, and online services.",
        "mcc_code": "5734",
        "mcc_category": "Computer Software Stores"
    },
    "requested_at": "2026-03-03T08:53:04.074Z",
    "completed_at": "2026-03-03T12:47:40.450Z"
}

200: In Progress

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "715d66fa-f174-4892-b49d-4d2fe4238861",
    "status": "in_progress",
    "requested_at": "2026-03-03T08:53:04.074Z"
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "aaf62018-1ece-4584-ba08-6da193881b9b",
    "status": "failed",
    "error": {
        "message": "We Couldn't Identify an MCC Code for the Provided Website.",
        "code": "ERROR"
    },
    "requested_at": "2023-01-12T08:53:04.074Z",
    "completed_at": "2024-03-07T10:08:23.172Z"
}

Get document details

GET https://secctrl.tutelar.io/api/v1/services/business_profile/mcc_finder

Query parameters description is given below,

Query Parameter	Type	Is Mandatory	Description
reference_id	String	Yes	Document reference id

200: Success Response

{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "1f61f84b-40fe-494b-9e36-22d926d0c427",
    "status": "completed",
    "result": {
        "mcc_code": "5651",
        "description": "FAMILY CLOTHING STORES",
        "category": "Clothing Stores",
        "risk_type": "medium",
        "is_highly_transactable_mcc": "-"
    },
    "requested_at": "2023-01-12T08:53:04.074Z",
    "completed_at": "2024-03-07T10:06:26.823Z"
}

200: In Progress Response

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "715d66fa-f174-4892-b49d-4d2fe4238861",
    "status": "in_progress",
    "requested_at": "2023-01-12T08:53:04.074Z"
}

200: Failure Response

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "aaf62018-1ece-4584-ba08-6da193881b9b",
    "status": "failed",
    "error": {
        "message": "We Couldn't Identify an MCC Code for the Provided Website.",
        "code": "ERROR"
    },
    "requested_at": "2024-01-12T08:53:04.074Z",
    "completed_at": "2024-03-07T10:08:23.172Z"
}