Approvals

Contains all endpoints regarding approval requests. Approval requests allow child users without direct withdrawal access to create a request to be reviewed.

This feature enables users who do not have direct withdrawal permission to initiate a withdrawal request that can then be reviewed by a user with approval permission.

Approvers have the option to approve or reject a request, while users who initiate a request have the ability to only cancel their own request.

Fetch approval requests

GET https://api.aquanow.io/accounts/v1/approval

Fetches the approval(s) given by the query parameter. NOTE: One of startTime or approvalId must be given as a query parameter. Query parameters can not be combined.

Query Parameters

Name	Type	Description
startTime	string	Pagination token that can be used to query more data NOTE: startTime must be within a 90 day range
approvalId	string	yyyy-mm-ddThh:mm:ss.sssZ UTC time stamp when approval request was created

200: OK Get approvals by approvalId

Returns an ApprovalsObject.

{
    "payload": {
        "transactionType": "WITHDRAW",
        "symbol": "USDT",
        "accountId": "CA1000052R",
        "address": "0xEE506212EE33ac1ac66D56e9Ea5D5866e8C7168e",
        "grossQuantity": 200,
        "accountName": "accountName1",
        "networkFee": 0.0001,
        "networkType": "eth"
    },
    "action": "WITHDRAW",
    "requestedBy": "userOne",
    "approvalId": "cba4e337-8876-46fe-9216-438a82ce7697",
    "status": "PENDING",
    "created": "2024-04-09T17:55:33.889Z",
    "username": "companyProfile",
    "reviewRecords": [],
    "entity": "Approval",
    "resource": "BALANCE",
    "approvalsGrossQuantity": 200,
    "approvalsQuantity": 199.9999,
}

200: OK Get approvals by startTime

500: Internal Server Error startTime is invalid

500: Internal Server Error starTime and approvalId are combined

500: Internal Server Error approvalId is invalid

400: Internal Server Error startTime exceeds 90 days

500: Internal Server Error startTime is in the future

500: Internal Server Error No query parameter is given

Create an approval request

POST https://api.aquanow.io/accounts/v1/approval

Please specify either grossQuantity or quantity inside the payload.

Request Body

Name	Type	Description
action*	string	BALANCE/WITHDRAW
payload*	obj	Contains an ApprovalsPayloadObject
	String

200: OK Create an approval request

Returns an ApprovalsObject.

{
    "approvalId": "6c0f9889-323a-4ad2-8041-e2dbddeeb7e8",
    "resource": "BALANCE",
    "action": "WITHDRAW",
    "payload": {
        "address": "0x80fB86611a28912a6D26D1bad078977402A324D9",
        "symbol": "USDC",
        "tag": "hi",
        "quantity": 1,
        "transactionType": "WITHDRAW",
        "networkFee": 0
    },
    "username": "alex_company",
    "requestedBy": "alex_company_ceo",
    "reviewRecords": [],
    "status": "PENDING",
    "approvalsGrossQuantity": 1,
    "approvalsQuantity": 1,
}

500: Internal Server Error Missing a required parameter

500: Internal Server Error Invalid parameter value

Cancel an approval request

DELETE https://api.aquanow.io/accounts/v1/approval

NOTE: Users can only cancel their own approval requests while the request status is PENDING.

Request Body

Name	Type	Description
approvalId*	string	approvalId of approval request

200: OK Cancel an approval request

Returns an ApprovalsObject.

{
    "approvalId": "58d5081e-82dc-4tcw-a820-8440e4dfo9c0",
    "status": "CANCELLED"
}

500: Internal Server Error Invalid approvalId

500: Internal Server Error Missing approvalId

Review an approval request

POST https://api.aquanow.io/accounts/v1/approval/review

User with approver permissions can approve or reject an approval request while the status is PENDING.

Request Body

Name	Type	Description
action*	string	APPROVE | REJECT
approvalId*	string	approvalId of approval request
comment	string	Comment set by reviewer

200: OK Review an approval request

Returns an ApprovalsObject.

{
    "approvalId": "58w5081e-82dc-49cw-a820-844oe4dfq9t4",
    "status": "APPROVED"
}

500: Internal Server Error Invalid/missing approvalId or action

500: Internal Server Error Approval request has been reviewed