# MCC Finder

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

## mcc\_finder

<mark style="color:green;">`POST`</mark> `https://secctrl.tutelar.io/api/v1/kyc/business_profile/mcc_finder`

### Post parameters description is given below,

<table><thead><tr><th width="158.3515625">Post Parameter </th><th width="92.390625">Type</th><th width="160.4375">Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td> website_url</td><td>String </td><td>Yes</td><td>Website Url</td></tr></tbody></table>

#### Sample Post Parameters

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

{% tabs %}
{% tab title=" 200: Success Response" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="200: In Progress " %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "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"
}
```

{% endtab %}
{% endtabs %}

## Get document details

<mark style="color:blue;">`GET`</mark> `https://secctrl.tutelar.io/api/v1/kyc/business_profile/mcc_finder`

### Query parameters description is given below,

<table><thead><tr><th width="197">Query Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>reference_id </td><td>String </td><td>Yes </td><td>Document reference id</td></tr></tbody></table>

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="200: In Progress Response" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "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"
}
```

{% endtab %}
{% endtabs %}