Get Account Roles

GET /v1/account/permission/role/:role

Retrieves a single account role by its unique identifier. The endpoint returns complete role information including metadata, associated features, and descriptive details about the role and its permissions. Use this to understand what capabilities and access rights are included in a specific role.

Response Example

{
  "_id": "640df6178d73a376cc1139eb",
  "name": "provider",
  "title": "Provider",
  "description": "Account type for service providers",
  "tags": ["Default"],
  "features": [
    {
      "_id": "640e6731c57beebe4a2a64ae",
      "namespace": "Platform/Own",
      "class": "system",
      "title": "Basic access to own information",
      "description": "Gives basic access to own information",
      "createdAt": "2023-03-12T23:58:41.428Z",
      "updatedAt": "2025-10-28T16:32:46.444Z"
    },
    {
      "_id": "640e6731c57beebe4a2a64c0",
      "namespace": "Platform/Account",
      "class": "system",
      "title": "Basic access to account(s)",
      "description": "Gives basic access to account, and account operations",
      "createdAt": "2023-03-12T23:58:41.428Z",
      "updatedAt": "2025-10-28T16:32:46.442Z"
    },
    {
      "_id": "640e6731c57beebe4a2a64a5",
      "namespace": "Platform/Contract",
      "class": "system",
      "title": "Basic access to contracts/agreements",
      "description": "Gives basic access to agreements",
      "createdAt": "2023-03-12T23:58:41.428Z",
      "updatedAt": "2025-10-28T16:32:46.442Z"
    },
    {
      "_id": "640e6731c57beebe4a2a648b",
      "namespace": "Platform/Discount",
      "class": "system",
      "title": "Basic access to discounts",
      "description": "Gives basic access to discounts",
      "createdAt": "2023-03-12T23:58:41.428Z",
      "updatedAt": "2025-10-28T16:32:46.442Z"
    },
    {
      "_id": "68edd765b4adf326024a8020",
      "namespace": "Bundles",
      "class": "system",
      "title": "Product Bundles",
      "description": "Access to build product Bundles",
      "createdAt": "2025-10-14T04:53:57.381Z",
      "updatedAt": "2025-10-28T16:32:46.444Z"
    }
  ],
  "createdAt": "2023-03-12T15:56:07.229Z",
  "updatedAt": "2025-10-21T15:56:01.044Z"
}