---
title: "Get Account Capabilities"
method: GET
path: "/distribution-wallets/{id}/capabilities"
tags: ["Distribution Wallets"]
---

# Get Account Capabilities

`GET /distribution-wallets/{id}/capabilities`

Reports what the caller may do on one distribution account, combining their tenant-wide role with the role they hold on that account.

Owners can also ask what a third party could do, by passing `user_id`. Add `role` alongside it to ask hypothetically what that user could do if granted that role. `role` cannot be sent on its own and returns 400 without `user_id`. This backs the dashboard's access-granting picker, which warns when a grant would be inert because the user's tenant-wide role already excludes the action.

## Path parameters

- `id` string, required

## Query parameters

- `user_id` string
- `role` 'financial_controller' | 'developer' | 'business' | 'initiator' | 'approver'

## Response `200`

Capabilities retrieved successfully

- WalletCapabilitiesResponse — What the subject may actually do on one account, combining their tenant-wide role with the role they hold on that account. Both gates apply, so this is reported as a capability set rather than a single effective role.
  - `wallet_id` string
  - `user_id` string — Present when the capabilities of another user were requested
  - `role` string — Present when the capabilities of a hypothetical role were requested
  - `capabilities` object

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found

## Changes

- **2026-08-31** `7588d8d2a3c7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/stellar/apis/stellar-disbursement-platform-api/changes/distribution-wallets/:id/capabilities/get.md)

---

[API](https://skmtc.dev/stellar/apis/stellar-disbursement-platform-api.md) · [All operations](https://skmtc.dev/stellar/apis/stellar-disbursement-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/stellar/stellar-disbursement-platform-api/revisions/7588d8d2a3c7/schema)