---
title: "Get access group"
method: GET
path: "/access-groups/{accessGroupId}"
tags: ["Access Group"]
---

# Get access group

`GET /access-groups/{accessGroupId}`

The ability to retrieve an access group by ID

## Path parameters

- `accessGroupId` string, required

## Response `200`

OK

- AccountAccessGroupWithDetailsResponse — AccessGroupWithDetails
  - `id` string — Unique ID for the access group
  - `name` string — Access group name
  - `type` 'SERVICE_PARTNER' | 'SERVICE_CUSTOMER' | 'DELEGATE' | 'USER_DEFINED' — The type of access group
  - `typeId` string — The identifier of the linked entity implied by the type, e.g. the partner ID
  - `status` 'ACTIVE' | 'DELETED' — Status of the access group
  - `countOfAccounts` integer — The number of accounts in this group
  - `accountIds` string[] — BIDs of Accounts in the group
  - `beneficiaryIds` string[] — BIDs of Beneficiaries in the group

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/modulrfinance/apis/modulr-api.md) · [All operations](https://skmtc.net/modulrfinance/apis/modulr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modulrfinance/modulr-api/revisions/cbd52524c8ef/schema)