Get transaction by transaction_id

This endpoint retrieves the details of a specific escrow transaction.

get escrow transaction

GET v2/escrow/transaction/get/:transaction_id

Params

NameTypeDescription

transaction_id

String

The transaction id of the created escrow

Headers

NameTypeDescription

Accept*

string

application/json

V-PRIVATE-KEY*

string

your vesicash private key

V-PUBLIC-KEY*

String

your vesicash public key

Response

The response will be in JSON format and will have the following schema:

```json
{
    "status": "success",
    "code": 200,
    "message": "success",
    "data": {
        "amount": 2000,
        "amount_left": 0,
        "amount_paid": 0,
        "business_id": 7064513869,
        "country": "NG",
        "created_at": "2024-07-17T14:31:54.213519Z",
        "currency": "NGN",
        "dashboard": "https://vesicash.com",
        "description": "Fourth transaction",
        "disbursement_charge": 200,
        "dispute_handler": "",
        "escrow_charge": 40,
        "files": [
            {
                "type": "",
                "url": ""
            }
        ],
        "id": 126,
        "milestones": [
            {
                "amount": 1000,
                "created_at": "2024-07-17T14:31:54.217441Z",
                "currency": "NGN",
                "delivered_at": 0,
                "description": "milestone 1 description",
                "disbursed_to_parties": null,
                "disbursement_retry_at": 1721228580,
                "due_date": "2024-03-19 15:04:05",
                "grace_period": 24,
                "id": 162,
                "inspection_period": 24,
                "milestone_id": "f32d6612ff524291aca8",
                "status": "Closed",
                "title": "milestone 1 for transaction 1",
                "transaction_id": "trc8bc0629cda04ed38eb6",
                "updated_at": "2024-07-17T14:43:06.432093Z"
            },
            {
                "amount": 1000,
                "created_at": "2024-07-17T14:31:54.217441Z",
                "currency": "NGN",
                "delivered_at": 0,
                "description": "milestone 1 description",
                "disbursed_to_parties": null,
                "disbursement_retry_at": 1721228580,
                "due_date": "2024-03-19 15:04:05",
                "grace_period": 24,
                "id": 163,
                "inspection_period": 24,
                "milestone_id": "6471e4afaf6545d8b71d",
                "status": "Closed",
                "title": "milestone 2 for transaction 1",
                "transaction_id": "trc8bc0629cda04ed38eb6",
                "updated_at": "2024-07-17T14:43:06.435934Z"
            }
        ],
        "parties": [
            {
                "bank_account": {
                    "account_name": "Chi H",
                    "account_number": "9226511842",
                    "bank_code": "VE000",
                    "bank_name": "Vesicash"
                },
                "created_at": "2024-07-17T14:31:54.210433Z",
                "email": "user@email.com",
                "first_name": "Ade",
                "has_accepted": true,
                "id": 273,
                "is_initiator": true,
                "last_name": "Chi",
                "percentage": 0,
                "phone": "+2349067362573",
                "role": "buyer",
                "role_description": "service buyer",
                "transaction_id": "trc8bc0629cda04ed38eb6",
                "transaction_party_id": "ca4b75b8d6704e8899fa",
                "updated_at": "2024-07-17T14:31:54.210433Z",
                "user_id": "9226511842"
            },
            {
                "bank_account": {
                    "account_name": "Chi H",
                    "account_number": "6255848431",
                    "bank_code": "VE000",
                    "bank_name": "Vesicash"
                },
                "created_at": "2024-07-17T14:31:54.210433Z",
                "email": "user33@email.com",
                "first_name": "Greg",
                "has_accepted": true,
                "id": 274,
                "is_initiator": false,
                "last_name": "Chi",
                "percentage": 90,
                "phone": "+2349067334573",
                "role": "seller",
                "role_description": "service seller",
                "transaction_id": "trc8bc0629cda04ed38eb6",
                "transaction_party_id": "4f70a1497e6946b5825d",
                "updated_at": "2024-07-17T14:41:29.17859Z",
                "user_id": "6255848431"
            },
            {
                "bank_account": {
                    "account_name": "Chi H",
                    "account_number": "2888413302",
                    "bank_code": "VE000",
                    "bank_name": "Vesicash"
                },
                "created_at": "2024-07-17T14:31:54.210433Z",
                "email": "user2@gmail.com",
                "first_name": "Greg",
                "has_accepted": false,
                "id": 275,
                "is_initiator": false,
                "last_name": "Chi",
                "percentage": 10,
                "phone": "+2349067334573",
                "role": "broker",
                "role_description": "transaction broker",
                "transaction_id": "trc8bc0629cda04ed38eb6",
                "transaction_party_id": "cda72bba716f41c1aad8",
                "updated_at": "2024-07-17T14:31:54.210433Z",
                "user_id": "2888413302"
            }
        ],
        "payment_status": "pending",
        "status": "Closed",
        "title": "Third transaction",
        "transaction_id": "trc8bc0629cda04ed38eb6",
        "type": "milestone",
        "updated_at": "2024-07-17T14:43:06.428688Z"
    }
}
```

Last updated