Compliance

Read account-level KYC and compliance state. These endpoints expose workflow state only; funding providers, decisions, and balance movement remain separate audited integrations.

Get my compliance state

Requires auth

GET/api/users/me/compliance

Returns the authenticated user's KYC status, tier, provider reference metadata, and manual compliance hold state.

Request

cURL

curl "https://api.majjha.fun/api/users/me/compliance" \
  -H "Authorization: Bearer $MAJJ_TOKEN"

Response

200 OK

{
  "userId": "usr_123",
  "kycStatus": "APPROVED",
  "kycTier": "FULL",
  "kycProvider": "socure",
  "kycReferenceId": "kyc_7a9...",
  "kycUpdatedAt": "2026-06-25T09:15:00",
  "complianceBlocked": false,
  "complianceClosedOnly": false,
  "complianceBlockReason": null,
  "complianceReviewedAt": "2026-06-25T09:16:00",
  "complianceReviewedBy": "admin_1",
  "updatedAt": "2026-06-25T09:16:00"
}

→Default users start at `NOT_STARTED` / `NONE` with no block.
→Current statuses are `NOT_STARTED`, `PENDING`, `DOC_REQUIRED`, `MANUAL_REVIEW`, `APPROVED`, `REJECTED`, and `EXPIRED`.
→`complianceClosedOnly` allows only close/reduce trading. Manual compliance blocks stop new order entry and funding handoffs. Setting `MAJJ_REQUIRE_KYC_APPROVAL=true` also requires `APPROVED` status for those actions.
→This endpoint does not start KYC, call a provider, or change balances.

PreviousExchange Next Search