> ## Documentation Index
> Fetch the complete documentation index at: https://razorpay.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch a Sub-Merchant's Risk Profile

> Fetch a sub-merchant account with the Accounts API to read Razorpay's risk rating, and receive the account.risk_profile.updated webhook when it changes.

Available in🇮🇳 India

Use this endpoint to read Razorpay's risk rating of a sub-merchant. Know more about [what the risk profile means](https://razorpay.com/docs/partners/aggregators/merchant-risk/risk-profile.md).

> [!NOTE]
>
> **Handy Tips**
>
> * This is the same call as Fetch an Account in the Accounts API. The response is the whole account. This page describes the `risk_profile` fields. The same response also carries the [actions](https://razorpay.com/docs/api/partners/accounts/merchant-risk/actions.md#response-parameters) and the [clarifications](https://razorpay.com/docs/api/partners/accounts/merchant-risk/clarifications.md#fetch-the-requirements) on the `payment_gateway` product.
> * A GET never changes state.
> * This endpoint needs the `onboarding_accounts_read` scope.

```bash Curl theme={null}
curl -X GET https://api.razorpay.com/v1/accounts/acc_Rk9Xm2Qp7Zt4Nb \
-u rzp_test_partner_[CLIENT_ID]:[CLIENT_SECRET]
```

```json Success theme={null}
{
  "id": "acc_Rk9Xm2Qp7Zt4Nb",
  "entity": "account",
  "risk_profile": {
    "rating": {
      "band": "medium",
      "updated_at": 1786000000
    }
  },
  "products": {
    "payment_gateway": {
      "status": "activated",
      "payment_acceptance": {
        "status": "enabled",
        "status_reason": null,
        "initiated_by": null,
        "updated_at": 1786000000
      },
      "settlement": {
        "status": "enabled",
        "status_reason": null,
        "initiated_by": null,
        "updated_at": 1786000000
      },
      "requirements": []
    }
  }
}
```

```json Not Rated Yet theme={null}
{
  "id": "acc_Rk9Xm2Qp7Zt4Nb",
  "entity": "account",
  "risk_profile": {
    "rating": {
      "band": "not_rated",
      "updated_at": null
    }
  },
  "products": {
    "payment_gateway": {
      "status": "activated",
      "payment_acceptance": {
        "status": "enabled",
        "status_reason": null,
        "initiated_by": null,
        "updated_at": 1786000000
      },
      "settlement": {
        "status": "enabled",
        "status_reason": null,
        "initiated_by": null,
        "updated_at": 1786000000
      },
      "requirements": []
    }
  }
}
```

## Path Parameters

**id** `string` *required*

The unique identifier of the account, `acc_` followed by 14 letters or digits. For example, `acc_Rk9Xm2Qp7Zt4Nb`.

## Response Parameters

**risk\_profile** `object`

Razorpay's risk profile of the sub-merchant. Read-only.

**properties**

**rating** `object`

Razorpay's risk rating of the sub-merchant. Razorpay assigns it around activation, from the business type, the Merchant Category Code (MCC) and category, and the registered location.

**properties**

**band** `string`

The rating. Possible values:

* `low`
* `medium`
* `high`
* `not_rated`: Razorpay has not rated the sub-merchant yet.

**updated\_at** `integer`

Unix timestamp at which the current rating took effect. `null` until the first rating.

**products.payment\_gateway** `object`

The `payment_gateway` product: its `status`, `payment_acceptance`, `settlement` and `requirements`. Know more about the [action fields](https://razorpay.com/docs/api/partners/accounts/merchant-risk/actions.md#response-parameters) and the [requirement fields](https://razorpay.com/docs/api/partners/accounts/merchant-risk/clarifications.md#requirement-entity).

## Webhook

Razorpay sends `account.risk_profile.updated` when it rates the sub-merchant for the first time, around activation, or changes its rating. The rating does not stop anything by itself. Know more about [subscribing to and handling webhooks](https://razorpay.com/docs/partners/aggregators/merchant-risk.md#receive-webhooks).

| Webhook Event | Description |
| - | - |
| `account.risk_profile.updated` | Razorpay rated the sub-merchant for the first time, or changed its rating. |

```json Payload theme={null}
{
  "entity": "event",
  "account_id": "acc_Rk9Xm2Qp7Zt4Nb",
  "event": "account.risk_profile.updated",
  "payload": {
    "account": {
      "id": "acc_Rk9Xm2Qp7Zt4Nb",
      "risk_profile": {
        "rating": {
          "band": "medium",
          "updated_at": 1786000000
        }
      }
    }
  },
  "created_at": 1786000001
}
```
