---
title: "Get an Organization's capabilities"
method: GET
path: "/api/organizations/{organizationId}/capabilities"
tags: ["Organizations"]
---

# Get an Organization's capabilities

`GET /api/organizations/{organizationId}/capabilities`

## Request

- Base URL: `https://api.muralpay.com`
- URL: `https://api.muralpay.com/api/organizations/{organizationId}/capabilities`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/muralpay/apis/mural-api/docs/api/organizations/:organizationId/capabilities/get.ts> (a function with typed inputs; its response is checked against the schema)

Get the payment capabilities of an organization. Every capability Mural supports is returned, each with this organization’s status for it, so a capability the organization does not hold appears as `notGranted` rather than being omitted. Only `active` capabilities can be used.

## Path parameters

- `organizationId` string, uuid, required

## Response `200`

The organization's capability rows.

- GetOrganizationCapabilitiesResponse: Every capability Mural supports, each with this organization’s status for it.
  - `capabilities` OrganizationCapability[], required: Every capability Mural supports, sorted by currency then direction. Capabilities the organization does not hold are included with a `notGranted` status.
    - `fiatCurrencyCode` 'USD' | 'COP' | 'ARS' | 'EUR' | 'AED' | 'AUD' | 'CAD' | 'CHF' | 'GBP' | 'HKD' | 'IDR' | 'INR' | 'MYR' | 'NZD' | 'PHP' | 'PLN' | 'SGD' | 'THB' | 'MXN' | 'BRL' | 'CLP' | 'PEN' | 'BOB' | 'CRC' | 'ZAR' | 'USD_PERU' | 'USD_CHINA' | 'USD_PANAMA' | 'USD_HONG_KONG' | 'USD_EL_SALVADOR' | 'USDT_TRON', required: Fiat currency of the capability
    - `rampDirection` 'ON_RAMP' | 'OFF_RAMP', required: Direction of the capability: `ON_RAMP` to receive funds into Mural accounts, `OFF_RAMP` to pay out of Mural accounts
    - `status` union, required: Status of the capability for this organization. Only `active` capabilities can be used.
      - OrganizationCapabilityStatusActive: The capability is active and the organization can use it for payments.
        - `type` 'active', required
      - OrganizationCapabilityStatusInReview: The capability is under review and is not yet available for use.
        - `type` 'inReview', required
      - OrganizationCapabilityStatusDisabled: The capability was disabled for this organization. Contact support to request access.
        - `type` 'disabled', required
      - OrganizationCapabilityStatusNotGranted: Mural supports this capability, but it was never granted to this organization. Contact support to request access.
        - `type` 'notGranted', required

## Other responses

- `401`: Unauthorized
- `403`: SignedAgreementRequiredException
- `404`: The organization does not exist, or is not the API key organization or one of its child organizations.
- `429`: RateLimitExceededError

## Changes

- **2026-11-03** `65aadbefe527`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/muralpay/apis/mural-api/changes/api/organizations/:organizationId/capabilities/get.md)

---

[API](https://skmtc.dev/muralpay/apis/mural-api.md) - [All operations](https://skmtc.dev/muralpay/apis/mural-api/llms.txt) - [OpenAPI document](https://skmtc.dev/muralpay/apis/mural-api/revisions/65aadbefe527?raw)