Get Organization KYC status

After creating an Organization and submitting KYB/KYC information, you can check the status of the its KYC approval by calling the GET endpoint.

If you did you KYC Onboarding through Compliance Reviews your organizations KYC status is viewable on the Compliance Review response and on the Organization response.

Example request

curl --request GET \
     --url https://api.muralpay.com/api/organizations/807742f0-e76c-44cd-bbe9-30b02e0060f4 \
     --header 'accept: application/json' \
     --header 'authorization: Bearer $API-KEY'

Example response

{
    "type": "business",
    "name": "Sun Tree Capital Llc",
    "id": "807742f0-e76c-44cd-bbe9-30b02e0060f4",
    "createdAt": "2025-04-04T16:32:17.074Z",
    "updatedAt": "2025-04-04T16:36:00.592Z",
    "kycStatus": {
      "type": "approved"
    },
    "tosStatus": ACCEPTED
    "currencyCapabilities": [
        {
            "fiatAndRailCode": "usd",
            "currencyCode": "USD",
            "depositStatus": {
                "type": "enabled"
            },
            "payOutStatus": {
                "type": "enabled"
            }
        },
        ...
    ]
}

{
    "type": "business",
    "name": "Sun Tree Capital LLC",
    "id": "807742f0-e76c-44cd-bbe9-30b02e0060f4",
    "createdAt": "2025-04-04T16:32:17.074Z",
    "updatedAt": "2025-04-04T16:32:17.074Z",
    "kycStatus": {
      "type": "rejected",
      "reason": "Unable to verify provided identification document"
    },
	  "tosStatus": ACCEPTED,
    "currencyInfos": []
}

Organization KYC Statuses

INACTIVE: The KYC process has not been started.
PENDING: The KYC process is in progress.
APPROVED: The KYC process is complete and approved.
ERROR: There was an error on the KYC process. Please contact support at [email protected].
REJECTED: The organization KYC process was rejected.

on-behalf-of Header

After an Organization's KYC is approved, you can perform operations using the Accounts API or Payouts API for that organization by adding the on-behalf-of to the endpoints that support it.

curl --request POST \
     --url https://api.muralpay.com/api/payouts/search \
     --header 'accept: application/json' \
     --header 'authorization: Bearer $API_KEY' \
     --header 'content-type: application/json' \
     --header 'on-behalf-of: 807742f0-e76c-44cd-bbe9-30b02e0060f4'