List escrow transactions

To fetch all transactions for a current authenticated user, make use of the endpoint below.

POST https://api.vesicash.com/v2/escrow-transaction-list

Fetch all escrow transactions

Query Parameters

Headers

Request Body

{
    "status": "success",
    "code": 200,
    "message": "successful",
    "data": [
        {
            "id": 2988,
            "transaction_id": "328a29deb5e146c8af25",
            "parties_id": "f4de747fefb34d6586b2",
            "milestone_id": "3a33b16504c347ca936f",
            "broker_id": "",
            "title": "Milestone payment",
            "type": "milestone",
            "description": "Milestone payment",
            "amount": 3000,
            "status": "Sent - Awaiting Confirmation",
            "quantity": 1,
            "inspection_period": "2",
            "due_date": "1700956800",
            "shipping_fee": 0,
            "grace_period": "",
            "currency": "NGN",
            "deleted_at": "0001-01-01T00:00:00Z",
            "created_at": "2023-11-24T10:00:39Z",
            "updated_at": "2023-11-24T10:00:40Z",
            "business_id": 7677378337,
            "is_paylinked": false,
            "source": "api",
            "trans_ussd_code": 24705,
            "recipients": [
                {
                    "account_id": 7031112514,
                    "amount": 1000,
                    "email_address": "",
                    "phone_number": ""
                },
                {
                    "account_id": 1104949388,
                    "amount": 2000,
                    "email_address": "",
                    "phone_number": ""
                }
            ],
            "dispute_handler": "vesicash",
            "amount_paid": 0,
            "escrow_charge": 245,
            "escrow_wallet": "yes",
            "products": [],
            "parties": {
                "broker": {
                    "id": 18620,
                    "transaction_parties_id": "f4de747fefb34d6586b2",
                    "transaction_id": "328a29deb5e146c8af25",
                    "account_id": 1104949388,
                    "role": "broker",
                    "deleted_at": "0001-01-01T00:00:00Z",
                    "created_at": "2023-11-24T10:00:39Z",
                    "updated_at": "2023-11-24T10:00:39Z",
                    "role_capabilities": {
                        "approve": false,
                        "can_receive": true,
                        "can_view": true,
                        "mark_as_done": false
                    },
                    "role_description": "",
                    "status": "Created"
                },
                "buyer": {
                    "id": 18618,
                    "transaction_parties_id": "f4de747fefb34d6586b2",
                    "transaction_id": "328a29deb5e146c8af25",
                    "account_id": 7677378337,
                    "role": "buyer",
                    "deleted_at": "0001-01-01T00:00:00Z",
                    "created_at": "2023-11-24T10:00:39Z",
                    "updated_at": "2023-11-24T10:00:39Z",
                    "role_capabilities": {
                        "approve": true,
                        "can_receive": false,
                        "can_view": true,
                        "mark_as_done": false
                    },
                    "role_description": "",
                    "status": "Accepted"
                },
                "seller": {
                    "id": 18619,
                    "transaction_parties_id": "f4de747fefb34d6586b2",
                    "transaction_id": "328a29deb5e146c8af25",
                    "account_id": 7031112514,
                    "role": "seller",
                    "deleted_at": "0001-01-01T00:00:00Z",
                    "created_at": "2023-11-24T10:00:39Z",
                    "updated_at": "2023-11-24T10:00:39Z",
                    "role_capabilities": {
                        "approve": false,
                        "can_receive": true,
                        "can_view": true,
                        "mark_as_done": true
                    },
                    "role_description": "",
                    "status": "Created"
                }
            },
            "members": [
                {
                    "party_id": 18620,
                    "account_id": 1104949388,
                    "account_name": "ISAAC JOSHUA",
                    "email": "user1@vesicash.com",
                    "phone_number": "2349212200011",
                    "role": "broker",
                    "status": "Created",
                    "access_level": {
                        "can_view": true,
                        "can_receive": true,
                        "mark_as_done": false,
                        "approve": false
                    }
                },
                {
                    "party_id": 18618,
                    "account_id": 7677378337,
                    "account_name": "Efemena Elvis",
                    "email": "user2@vesicash.com",
                    "phone_number": "09213300090",
                    "role": "buyer",
                    "status": "Accepted",
                    "access_level": {
                        "can_view": true,
                        "can_receive": false,
                        "mark_as_done": false,
                        "approve": true
                    }
                },
                {
                    "party_id": 18619,
                    "account_id": 7031112514,
                    "account_name": "Rich Elvis",
                    "email": "user3@vesicash.com",
                    "phone_number": "09212211101",
                    "role": "seller",
                    "status": "Created",
                    "access_level": {
                        "can_view": true,
                        "can_receive": true,
                        "mark_as_done": true,
                        "approve": false
                    }
                }
            ],
            "files": [],
            "total_amount": 7350,
            "milestones": [
                {
                    "index": 1,
                    "milestone_id": "3a33b16504c347ca936f",
                    "title": "First Quarter",
                    "amount": 3000,
                    "status": "Sent - Awaiting Confirmation",
                    "inspection_period": "2",
                    "due_date": "1700956800",
                    "recipients": [
                        {
                            "account_id": 7031112514,
                            "account_name": "Rich Elvis",
                            "email": "user3@vesicash.com",
                            "phone_number": "09212211101",
                            "amount": 1000
                        },
                        {
                            "account_id": 1104949388,
                            "account_name": "ISAAC JOSHUA",
                            "email": "user2@vesicash.com",
                            "phone_number": "2349212200011",
                            "amount": 2000
                        }
                    ]
                },
                {
                    "index": 2,
                    "milestone_id": "9b608f54c5b347a890e5",
                    "title": "Second Quarter",
                    "amount": 4000,
                    "status": "Sent - Awaiting Confirmation",
                    "inspection_period": "2",
                    "due_date": "1701216000",
                    "recipients": [
                        {
                            "account_id": 7031112514,
                            "account_name": "Rich Elvis",
                            "email": "user3@vesicash.com",
                            "phone_number": "09212211101",
                            "amount": 1500
                        },
                        {
                            "account_id": 1104949388,
                            "account_name": "ISAAC JOSHUA",
                            "email": "user2@vesicash.com",
                            "phone_number": "2349212200011",
                            "amount": 2500
                        }
                    ]
                }
            ],
            "broker": {
                "id": 0,
                "transaction_broker_id": "",
                "transaction_id": "328a29deb5e146c8af25",
                "broker_charge": "",
                "broker_charge_bearer": "",
                "created_at": "0001-01-01T00:00:00Z",
                "updated_at": "0001-01-01T00:00:00Z",
                "broker_charge_type": "",
                "is_seller_accepted": false,
                "is_buyer_accepted": false
            },
            "activities": [
                {
                    "id": 1644,
                    "transaction_id": "328a29deb5e146c8af25",
                    "description": "Transaction details have been sent to all invited parties",
                    "deleted_at": "0001-01-01T00:00:00Z",
                    "created_at": "2023-11-24T10:00:39Z",
                    "updated_at": "2023-11-24T10:00:39Z"
                }
            ],
            "country": {
                "id": 0,
                "name": "",
                "country_code": "",
                "currency_code": "",
                "created_at": "",
                "updated_at": ""
            },
            "due_date_formatted": "",
            "transaction_closed_at": "0001-01-01T00:00:00Z",
            "is_disputed": false
        },
        {
            "id": 2964,
            "transaction_id": "2c6a044299f0425f97ed",
            "parties_id": "75fd0cd3f3664fdeaa83",
            "milestone_id": "6a0161b25a644a3c8daf",
            "broker_id": "",
            "title": "name",
            "type": "oneoff",
            "description": "name",
            "amount": 21000,
            "status": "Sent - Awaiting Confirmation",
            "quantity": 0,
            "inspection_period": "2",
            "due_date": "1690243200",
            "shipping_fee": 0,
            "grace_period": "",
            "currency": "NGN",
            "deleted_at": "0001-01-01T00:00:00Z",
            "created_at": "2023-07-24T11:53:45Z",
            "updated_at": "2023-07-24T11:53:59Z",
            "business_id": 7677378337,
            "is_paylinked": false,
            "source": "api",
            "trans_ussd_code": 44214,
            "recipients": [
                {
                    "account_id": 4435451574,
                    "amount": 20000,
                    "email_address": "",
                    "phone_number": ""
                }
            ],
            "dispute_handler": "vesicash",
            "amount_paid": 21000,
            "escrow_charge": 700,
            "escrow_wallet": "yes",
            "products": [],
            "parties": {
                "buyer": {
                    "id": 18580,
                    "transaction_parties_id": "75fd0cd3f3664fdeaa83",
                    "transaction_id": "2c6a044299f0425f97ed",
                    "account_id": 7677378337,
                    "role": "buyer",
                    "deleted_at": "0001-01-01T00:00:00Z",
                    "created_at": "2023-07-24T11:53:45Z",
                    "updated_at": "2023-07-24T11:53:45Z",
                    "role_capabilities": {
                        "approve": true,
                        "can_receive": false,
                        "can_view": true,
                        "mark_as_done": false
                    },
                    "role_description": "",
                    "status": "Accepted"
                },
                "seller": {
                    "id": 18581,
                    "transaction_parties_id": "75fd0cd3f3664fdeaa83",
                    "transaction_id": "2c6a044299f0425f97ed",
                    "account_id": 4435451574,
                    "role": "seller",
                    "deleted_at": "0001-01-01T00:00:00Z",
                    "created_at": "2023-07-24T11:53:45Z",
                    "updated_at": "2023-07-24T11:53:45Z",
                    "role_capabilities": {
                        "approve": false,
                        "can_receive": true,
                        "can_view": true,
                        "mark_as_done": true
                    },
                    "role_description": "",
                    "status": "Created"
                }
            },
            "members": [
                {
                    "party_id": 18580,
                    "account_id": 7677378337,
                    "account_name": "",
                    "email": "",
                    "phone_number": "",
                    "role": "buyer",
                    "status": "Accepted",
                    "access_level": {
                        "can_view": true,
                        "can_receive": false,
                        "mark_as_done": false,
                        "approve": true
                    }
                },
                {
                    "party_id": 18581,
                    "account_id": 4435451574,
                    "account_name": "ISAAC JOSHUA",
                    "email": "user2@vesicash.com",
                    "phone_number": "08051162014",
                    "role": "seller",
                    "status": "Created",
                    "access_level": {
                        "can_view": true,
                        "can_receive": true,
                        "mark_as_done": true,
                        "approve": false
                    }
                }
            ],
            "files": [],
            "total_amount": 21000,
            "milestones": [
                {
                    "index": 1,
                    "milestone_id": "6a0161b25a644a3c8daf",
                    "title": "Milestone 1",
                    "amount": 21000,
                    "status": "Sent - Awaiting Confirmation",
                    "inspection_period": "2",
                    "due_date": "1690243200",
                    "recipients": [
                        {
                            "account_id": 4435451574,
                            "account_name": "ISAAC JOSHUA",
                            "email": "user2@vesicash.com",
                            "phone_number": "08051162014",
                            "amount": 20000
                        }
                    ]
                }
            ],
            "broker": {
                "id": 0,
                "transaction_broker_id": "",
                "transaction_id": "2c6a044299f0425f97ed",
                "broker_charge": "",
                "broker_charge_bearer": "",
                "created_at": "0001-01-01T00:00:00Z",
                "updated_at": "0001-01-01T00:00:00Z",
                "broker_charge_type": "",
                "is_seller_accepted": false,
                "is_buyer_accepted": false
            },
            "activities": [
                {
                    "id": 1606,
                    "transaction_id": "2c6a044299f0425f97ed",
                    "description": "Transaction details have been sent to all invited parties",
                    "deleted_at": "0001-01-01T00:00:00Z",
                    "created_at": "2023-07-24T11:53:45Z",
                    "updated_at": "2023-07-24T11:53:45Z"
                }
            ],
            "country": {
                "id": 0,
                "name": "",
                "country_code": "",
                "currency_code": "",
                "created_at": "",
                "updated_at": ""
            },
            "due_date_formatted": "",
            "transaction_closed_at": "0001-01-01T00:00:00Z",
            "is_disputed": false
        }
    ],
    "pagination": [
        {
            "current_page": 1,
            "page_count": 3,
            "total_pages_count": 3
        }
    ]
}

Last updated