Transactional Policy - Approvals

Get pending approvals

get/api/v1/organizations/{organizationId}/policy/approvals

Request

  • Base URL: https://api-sandbox.koywe.com
  • URL: https://api-sandbox.koywe.com/api/v1/organizations/{organizationId}/policy/approvals
  • Auth: HTTP bearer

Path parameters

organizationIdstring required

Query parameters

merchantIdstring
scope'mine' | 'requested' | 'all'

mine: approvals assigned to you (default). requested: approvals requested by you. all: all pending approvals.

operationType'PAYOUT_FIAT' | 'PAYOUT_CRYPTO' | 'BALANCE_TRANSFER' | 'POLICY_MANAGE' | 'DESTINATION_EDIT' | 'PASSKEY_ENROLL' | 'API_USER_MFA_ENROLL' | 'API_USER_MFA_REVOKE' | 'EMBEDDED_WALLET_ACCESS_GRANT' | 'USER_INVITE'

Optional filter by operation type (e.g. PAYOUT_FIAT).

Response

idstring required
policyIdstring required
ruleIdstring required
operationType'PAYOUT_FIAT' | 'PAYOUT_CRYPTO' | 'BALANCE_TRANSFER' | 'POLICY_MANAGE' | 'DESTINATION_EDIT' | 'PASSKEY_ENROLL' | 'API_USER_MFA_ENROLL' | 'API_USER_MFA_REVOKE' | 'EMBEDDED_WALLET_ACCESS_GRANT' | 'USER_INVITE' required
merchantIdstring required
resourceTypestring
resourceOwnerType'merchant' | 'contact'

Ownership scope of the target resource when the approval applies to a merchant-owned or contact-owned resource.

resourceIdstring

Resource identifier when known. For create-on-approve flows this may contain the placeholder PENDING_CREATION until the resource exists.

contactIdstring

Contact ID when the approval targets a contact-owned resource.

amountUsdnumber required
approvalMode'ANY_OF' | 'ALL_OF' | 'THRESHOLD' required
approvalThresholdnumber
mfaRequiredboolean required
mfaRequiredFrom'REQUESTER' | 'APPROVER' required
mfaCompletedByTurnkeyUserIdstring nullable
mfaCompletedAtstring date-time nullable
status'PENDING' | 'APPROVED' | 'REJECTED' | 'EXPIRED' required
expiresAtstring date-time required
createdAtstring date-time required
updatedAtstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.