> For the complete documentation index, see [llms.txt](https://rymera.gitbook.io/wholesale-suite-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://rymera.gitbook.io/wholesale-suite-api/wholesale-v1-wwpp/wholesale-role/retrieve-a-wholesale-role.md).

# Retrieve a Wholesale Role

This API allows you to fetch specific wholesale role data.

{% tabs %}
{% tab title="Request" %}

| Method | Endpoint                                |
| ------ | --------------------------------------- |
| GET    | /wp-json/wholesale/v1/roles/{role\_key} |

| Path parameters | Type     | Required | Description        |
| --------------- | -------- | -------- | ------------------ |
| role\_key       | required | string   | Wholesale role key |
| {% endtab %}    |          |          |                    |

{% tab title="Request Example" %}

#### Postman

Fetch wholesale role

```php
GET: /wp-json/wholesale/v1/roles/bronze
```

{% endtab %}

{% tab title="Response Example" %}

#### Status: 200 OK

```
{
    "roleName": "Bronze",
    "desc": "",
    "onlyAllowWholesalePurchases": "no"
}
```

#### Status: 403 Forbidden

Invalid wholesale role key

```
{
    "code": "wholesale_rest_cannot_view",
    "message": "Item not found.",
    "data": {
        "status": 403
    }
}
```

{% endtab %}
{% endtabs %}