Piggyvest Business

Introduction

API Doc

Webhooks

Pay With Pocket

DocsTransaction Status Query
Ctrl K

Transaction Status Query (TSQ)

GET/api/v1/transfer/status/:reference

Check the status of a specific transfer request.

Path Parameters

NameTypeRequiredDescription
referencestringYesTransaction reference.
1
Request Example
(cURL)
curl -X GET "https://api.piggyvest.business/api/v1/transfer/status/:reference" \\
-H "Authorization: Bearer YOUR_SECRET_KEY"
2
Success Response(200)
(JSON)
{
  "status": true,
  "message": "Transaction status retrieved",
  "data": {
    "reference": "PVB1234567890",
    "status": "success",
    "amount": 10000,
    "recipient": "0123456789",
    "bank": "GTBank",
    "created_at": "2024-03-25T12:00:00Z"
  }
}

Status values includes: "success", "pending", "failed"